<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="43">Copy of @self</doc>
+ line="46">Copy of @self</doc>
<type name="BootconfigParser" c:type="OstreeBootconfigParser*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="41">Bootconfig to clone</doc>
+ line="44">Bootconfig to clone</doc>
<type name="BootconfigParser" c:type="OstreeBootconfigParser*"/>
</instance-parameter>
</parameters>
</parameter>
</parameters>
</method>
+ <method name="get_overlay_initrds"
+ c:identifier="ostree_bootconfig_parser_get_overlay_initrds"
+ version="2020.7">
+ <source-position filename="ostree-bootconfig-parser.h" line="81"/>
+ <return-value transfer-ownership="none" nullable="1">
+ <doc xml:space="preserve"
+ filename="ostree-bootconfig-parser.c"
+ line="178">Array of initrds or %NULL
+if none are set.</doc>
+ <array c:type="char**">
+ <type name="utf8"/>
+ </array>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-bootconfig-parser.c"
+ line="176">Parser</doc>
+ <type name="BootconfigParser" c:type="OstreeBootconfigParser*"/>
+ </instance-parameter>
+ </parameters>
+ </method>
<method name="parse"
c:identifier="ostree_bootconfig_parser_parse"
throws="1">
throws="1">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="56">Initialize a bootconfig from the given file.</doc>
+ line="61">Initialize a bootconfig from the given file.</doc>
<source-position filename="ostree-bootconfig-parser.h" line="48"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="58">Parser</doc>
+ line="63">Parser</doc>
<type name="BootconfigParser" c:type="OstreeBootconfigParser*"/>
</instance-parameter>
<parameter name="dfd" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="59">Directory fd</doc>
+ line="64">Directory fd</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="60">File path</doc>
+ line="65">File path</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-bootconfig-parser.c"
- line="61">Cancellable</doc>
+ line="66">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</parameter>
</parameters>
</method>
+ <method name="set_overlay_initrds"
+ c:identifier="ostree_bootconfig_parser_set_overlay_initrds"
+ version="2020.7">
+ <doc xml:space="preserve"
+ filename="ostree-bootconfig-parser.c"
+ line="154">These are rendered as additional `initrd` keys in the final bootloader configs. The
+base initrd is part of the primary keys.</doc>
+ <source-position filename="ostree-bootconfig-parser.h" line="77"/>
+ <return-value transfer-ownership="none">
+ <type name="none" c:type="void"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-bootconfig-parser.c"
+ line="156">Parser</doc>
+ <type name="BootconfigParser" c:type="OstreeBootconfigParser*"/>
+ </instance-parameter>
+ <parameter name="initrds"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-bootconfig-parser.c"
+ line="157">Array of overlay
+ initrds or %NULL to unset.</doc>
+ <array c:type="char**">
+ <type name="utf8" c:type="char*"/>
+ </array>
+ </parameter>
+ </parameters>
+ </method>
<method name="write"
c:identifier="ostree_bootconfig_parser_write"
throws="1">
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="165">New deep copy of @self</doc>
+ line="193">New deep copy of @self</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="163">Deployment</doc>
+ line="191">Deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</instance-parameter>
</parameters>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="211">%TRUE if deployments have the same osname, csum, and deployserial</doc>
+ line="241">%TRUE if deployments have the same osname, csum, and deployserial</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="ap" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="208">A deployment</doc>
+ line="238">A deployment</doc>
<type name="Deployment" c:type="gconstpointer"/>
</instance-parameter>
<parameter name="bp" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="209">A deployment</doc>
+ line="239">A deployment</doc>
<type name="Deployment" c:type="gconstpointer"/>
</parameter>
</parameters>
c:identifier="ostree_deployment_get_origin_relpath">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="286">Note this function only returns a *relative* path - if you want to
+ line="318">Note this function only returns a *relative* path - if you want to
access, it, you must either use fd-relative api such as openat(),
or concatenate it with the full ostree_sysroot_get_path().</doc>
<source-position filename="ostree-deployment.h" line="97"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="294">Path to deployment root directory, relative to sysroot</doc>
+ line="326">Path to deployment root directory, relative to sysroot</doc>
<type name="utf8" c:type="char*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="288">A deployment</doc>
+ line="320">A deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</instance-parameter>
</parameters>
version="2018.3">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="338">See ostree_sysroot_deployment_set_pinned().</doc>
+ line="370">See ostree_sysroot_deployment_set_pinned().</doc>
<source-position filename="ostree-deployment.h" line="79"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="344">`TRUE` if deployment will not be subject to GC</doc>
+ line="376">`TRUE` if deployment will not be subject to GC</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="340">Deployment</doc>
+ line="372">Deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</instance-parameter>
</parameters>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="359">`TRUE` if deployment should be "finalized" at shutdown time</doc>
+ line="391">`TRUE` if deployment should be "finalized" at shutdown time</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-deployment.c"
- line="357">Deployment</doc>
+ line="389">Deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</instance-parameter>
</parameters>
<function-macro name="IS_REPO"
c:identifier="OSTREE_IS_REPO"
introspectable="0">
- <source-position filename="ostree-repo.h" line="41"/>
+ <source-position filename="ostree-repo.h" line="42"/>
<parameters>
<parameter name="obj">
</parameter>
version="2018.9">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1443">GVariant type `s`. This key can be used in the repo metadata which is stored
+ line="1459">GVariant type `s`. This key can be used in the repo metadata which is stored
in OSTREE_REPO_METADATA_REF as well as in the summary. The semantics of this
are that the remote repository wants clients to update their remote config
to add this collection ID (clients can't do P2P operations involving a
This is a replacement for the similar metadata key implemented by flatpak,
`xa.collection-id`, which is now deprecated as clients which supported it had
bugs with their P2P implementations.</doc>
- <source-position filename="ostree-repo.h" line="1464"/>
+ <source-position filename="ostree-repo.h" line="1480"/>
<type name="utf8" c:type="gchar*"/>
</constant>
<function-macro name="MUTABLE_TREE"
</member>
</enumeration>
<constant name="RELEASE_VERSION"
- value="6"
+ value="7"
c:type="OSTREE_RELEASE_VERSION"
version="2017.4">
<doc xml:space="preserve"
<type name="gint" c:type="gint"/>
</constant>
<function-macro name="REPO" c:identifier="OSTREE_REPO" introspectable="0">
- <source-position filename="ostree-repo.h" line="39"/>
+ <source-position filename="ostree-repo.h" line="40"/>
<parameters>
<parameter name="obj">
</parameter>
version="2018.6">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1420">The name of a ref which is used to store metadata for the entire repository,
+ line="1436">The name of a ref which is used to store metadata for the entire repository,
such as its expected update time (`ostree.summary.expires`), name, or new
GPG keys. Metadata is stored on contentless commits in the ref, and hence is
signed with the commits.
Users of OSTree may place arbitrary metadata in commits on this ref, but the
keys must be namespaced by product or developer. For example,
`exampleos.end-of-life`. The `ostree.` prefix is reserved.</doc>
- <source-position filename="ostree-repo.h" line="1441"/>
+ <source-position filename="ostree-repo.h" line="1457"/>
<type name="utf8" c:type="gchar*"/>
</constant>
<record name="Remote"
glib:type-name="OstreeRepo"
glib:get-type="ostree_repo_get_type">
<constructor name="new" c:identifier="ostree_repo_new">
- <source-position filename="ostree-repo.h" line="53"/>
+ <source-position filename="ostree-repo.h" line="54"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
Otherwise use the path in the OSTREE_REPO environment variable
(if defined) or else the default system repository located at
/ostree/repo.</doc>
- <source-position filename="ostree-repo.h" line="60"/>
+ <source-position filename="ostree-repo.h" line="61"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="1300">Creates a new #OstreeRepo instance, taking the system root path explicitly
instead of assuming "/".</doc>
- <source-position filename="ostree-repo.h" line="56"/>
+ <source-position filename="ostree-repo.h" line="57"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
The @options dict may contain:
- collection-id: s: Set as collection ID in repo/config (Since 2017.9)</doc>
- <source-position filename="ostree-repo.h" line="101"/>
+ <source-position filename="ostree-repo.h" line="102"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
<function name="mode_from_string"
c:identifier="ostree_repo_mode_from_string"
throws="1">
- <source-position filename="ostree-repo.h" line="45"/>
+ <source-position filename="ostree-repo.h" line="46"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="1265">This combines ostree_repo_new() (but using fd-relative access) with
ostree_repo_open(). Use this when you know you should be operating on an
already extant repository. If you want to create one, use ostree_repo_create_at().</doc>
- <source-position filename="ostree-repo.h" line="69"/>
+ <source-position filename="ostree-repo.h" line="70"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
Compatibility note: this function previously assumed that @user_data
was a pointer to a #GSConsole instance. This is no longer the case,
and @user_data is ignored.</doc>
- <source-position filename="ostree-repo.h" line="1317"/>
+ <source-position filename="ostree-repo.h" line="1333"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
line="297">This hash table is a mapping from #GVariant which can be accessed
via ostree_object_name_deserialize() to a #GVariant containing either
a similar #GVariant or and array of them, listing the parents of the key.</doc>
- <source-position filename="ostree-repo.h" line="1081"/>
+ <source-position filename="ostree-repo.h" line="1097"/>
<return-value transfer-ownership="container">
<doc xml:space="preserve"
filename="ostree-repo-traverse.c"
filename="ostree-repo-traverse.c"
line="282">This hash table is a set of #GVariant which can be accessed via
ostree_object_name_deserialize().</doc>
- <source-position filename="ostree-repo.h" line="1078"/>
+ <source-position filename="ostree-repo.h" line="1094"/>
<return-value transfer-ownership="container">
<doc xml:space="preserve"
filename="ostree-repo-traverse.c"
filename="ostree-repo-traverse.c"
line="348">Gets all the commits that a certain object belongs to, as recorded
by a parents table gotten from ostree_repo_traverse_commit_union_with_parents.</doc>
- <source-position filename="ostree-repo.h" line="1084"/>
+ <source-position filename="ostree-repo.h" line="1100"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo-traverse.c"
discarded. You *must* invoke this if you have chosen not to invoke
ostree_repo_commit_transaction(). Calling this function when not in a
transaction will do nothing and return successfully.</doc>
- <source-position filename="ostree-repo.h" line="328"/>
+ <source-position filename="ostree-repo.h" line="329"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo.c"
line="5160">Add a GPG signature to a summary file.</doc>
- <source-position filename="ostree-repo.h" line="1367"/>
+ <source-position filename="ostree-repo.h" line="1383"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo.c"
line="4939">Append a GPG signature to a commit.</doc>
- <source-position filename="ostree-repo.h" line="1374"/>
+ <source-position filename="ostree-repo.h" line="1390"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1305">Similar to ostree_repo_checkout_tree(), but uses directory-relative
+ line="1321">Similar to ostree_repo_checkout_tree(), but uses directory-relative
paths for the destination, uses a new `OstreeRepoCheckoutAtOptions`,
and takes a commit checksum and optional subpath pair, rather than
requiring use of `GFile` APIs for the caller.
Note in addition that unlike ostree_repo_checkout_tree(), the
default is not to use the repository-internal uncompressed objects
cache.</doc>
- <source-position filename="ostree-repo.h" line="985"/>
+ <source-position filename="ostree-repo.h" line="986"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1307">Repo</doc>
+ line="1323">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="options"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1308">Options</doc>
+ line="1324">Options</doc>
<type name="RepoCheckoutAtOptions"
c:type="OstreeRepoCheckoutAtOptions*"/>
</parameter>
<parameter name="destination_dfd" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1309">Directory FD for destination</doc>
+ line="1325">Directory FD for destination</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="destination_path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1310">Directory for destination</doc>
+ line="1326">Directory for destination</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="commit" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1311">Checksum for commit</doc>
+ line="1327">Checksum for commit</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1312">Cancellable</doc>
+ line="1328">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1444">Call this after finishing a succession of checkout operations; it
+ line="1460">Call this after finishing a succession of checkout operations; it
will delete any currently-unused uncompressed objects from the
cache.</doc>
- <source-position filename="ostree-repo.h" line="994"/>
+ <source-position filename="ostree-repo.h" line="995"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1446">Repo</doc>
+ line="1462">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1447">Cancellable</doc>
+ line="1463">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1223">Check out @source into @destination, which must live on the
+ line="1239">Check out @source into @destination, which must live on the
physical filesystem. @source may be any subdirectory of a given
commit. The @mode and @overwrite_mode allow control over how the
files are checked out.</doc>
- <source-position filename="ostree-repo.h" line="900"/>
+ <source-position filename="ostree-repo.h" line="901"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1225">Repo</doc>
+ line="1241">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="mode" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1226">Options controlling all files</doc>
+ line="1242">Options controlling all files</doc>
<type name="RepoCheckoutMode" c:type="OstreeRepoCheckoutMode"/>
</parameter>
<parameter name="overwrite_mode" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1227">Whether or not to overwrite files</doc>
+ line="1243">Whether or not to overwrite files</doc>
<type name="RepoCheckoutOverwriteMode"
c:type="OstreeRepoCheckoutOverwriteMode"/>
</parameter>
<parameter name="destination" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1228">Place tree here</doc>
+ line="1244">Place tree here</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<parameter name="source" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1229">Source tree</doc>
+ line="1245">Source tree</doc>
<type name="RepoFile" c:type="OstreeRepoFile*"/>
</parameter>
<parameter name="source_info" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1230">Source info</doc>
+ line="1246">Source info</doc>
<type name="Gio.FileInfo" c:type="GFileInfo*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1231">Cancellable</doc>
+ line="1247">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1262">Similar to ostree_repo_checkout_tree(), but uses directory-relative
+ line="1278">Similar to ostree_repo_checkout_tree(), but uses directory-relative
paths for the destination, uses a new `OstreeRepoCheckoutAtOptions`,
and takes a commit checksum and optional subpath pair, rather than
requiring use of `GFile` APIs for the caller.
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1264">Repo</doc>
+ line="1280">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="options"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1265">Options</doc>
+ line="1281">Options</doc>
<type name="RepoCheckoutOptions"
c:type="OstreeRepoCheckoutOptions*"/>
</parameter>
<parameter name="destination_dfd" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1266">Directory FD for destination</doc>
+ line="1282">Directory FD for destination</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="destination_path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1267">Directory for destination</doc>
+ line="1283">Directory for destination</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="commit" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1268">Checksum for commit</doc>
+ line="1284">Checksum for commit</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1269">Cancellable</doc>
+ line="1285">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
Locking: Releases `shared` lock acquired by `ostree_repo_prepare_transaction()`
Multithreading: This function is *not* MT safe; only one transaction can be
active at a time.</doc>
- <source-position filename="ostree-repo.h" line="322"/>
+ <source-position filename="ostree-repo.h" line="323"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
</parameters>
</method>
<method name="copy_config" c:identifier="ostree_repo_copy_config">
- <source-position filename="ostree-repo.h" line="144"/>
+ <source-position filename="ostree-repo.h" line="145"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
This function predates ostree_repo_create_at(). It is an error to call
this function on a repository initialized via ostree_repo_open_at().</doc>
- <source-position filename="ostree-repo.h" line="96"/>
+ <source-position filename="ostree-repo.h" line="97"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="4234">Remove the object of type @objtype with checksum @sha256
from the repository. An error of type %G_IO_ERROR_NOT_FOUND
is thrown if the object does not exist.</doc>
- <source-position filename="ostree-repo.h" line="606"/>
+ <source-position filename="ostree-repo.h" line="607"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="3508">Check whether two opened repositories are the same on disk: if their root
directories are the same inode. If @a or @b are not open yet (due to
ostree_repo_open() not being called on them yet), %FALSE will be returned.</doc>
- <source-position filename="ostree-repo.h" line="130"/>
+ <source-position filename="ostree-repo.h" line="131"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo-libarchive.c"
line="1223">Import an archive file @archive into the repository, and write its
file structure to @mtree.</doc>
- <source-position filename="ostree-repo.h" line="823"/>
+ <source-position filename="ostree-repo.h" line="824"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
version="2018.6">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4933">Find reachable remote URIs which claim to provide any of the given named
+ line="4946">Find reachable remote URIs which claim to provide any of the given named
@refs. This will search for configured remotes (#OstreeRepoFinderConfig),
mounted volumes (#OstreeRepoFinderMount) and (if enabled at compile time)
local network peers (#OstreeRepoFinderAvahi). In order to use a custom
GPG verification of commits will be used unconditionally.
This will use the thread-default #GMainContext, but will not iterate it.</doc>
- <source-position filename="ostree-repo.h" line="1276"/>
+ <source-position filename="ostree-repo.h" line="1292"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4935">an #OstreeRepo</doc>
+ line="4948">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="refs" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4936">non-empty array of collection–ref pairs to find remotes for</doc>
+ line="4949">non-empty array of collection–ref pairs to find remotes for</doc>
<array c:type="const OstreeCollectionRef* const*">
<type name="CollectionRef" c:type="OstreeCollectionRef*"/>
</array>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4937">a GVariant `a{sv}` with an extensible set of flags</doc>
+ line="4950">a GVariant `a{sv}` with an extensible set of flags</doc>
<type name="GLib.Variant" c:type="GVariant*"/>
</parameter>
<parameter name="finders" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4938">non-empty array of
+ line="4951">non-empty array of
#OstreeRepoFinder instances to use, or %NULL to use the system defaults</doc>
<array c:type="OstreeRepoFinder**">
<type name="RepoFinder" c:type="OstreeRepoFinder*"/>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4940">an #OstreeAsyncProgress to update with the operation’s
+ line="4953">an #OstreeAsyncProgress to update with the operation’s
progress, or %NULL</doc>
<type name="AsyncProgress" c:type="OstreeAsyncProgress*"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4942">a #GCancellable, or %NULL</doc>
+ line="4955">a #GCancellable, or %NULL</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback"
closure="6">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4943">asynchronous completion callback</doc>
+ line="4956">asynchronous completion callback</doc>
<type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="4944">data to pass to @callback</doc>
+ line="4957">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5730">Finish an asynchronous pull operation started with
+ line="5743">Finish an asynchronous pull operation started with
ostree_repo_find_remotes_async().</doc>
- <source-position filename="ostree-repo.h" line="1285"/>
+ <source-position filename="ostree-repo.h" line="1301"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5739">a potentially empty array
+ line="5752">a potentially empty array
of #OstreeRepoFinderResults, followed by a %NULL terminator element; or
%NULL on error</doc>
<array c:type="OstreeRepoFinderResult**">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5732">an #OstreeRepo</doc>
+ line="5745">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5733">the asynchronous result</doc>
+ line="5746">the asynchronous result</doc>
<type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
line="4350">Verify consistency of the object; this performs checks only relevant to the
immediate object itself, such as checksumming. This API call will not itself
traverse metadata objects for example.</doc>
- <source-position filename="ostree-repo.h" line="613"/>
+ <source-position filename="ostree-repo.h" line="614"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
version="2019.2">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6233">Get the bootloader configured. See the documentation for the
+ line="6244">Get the bootloader configured. See the documentation for the
"sysroot.bootloader" config key.</doc>
- <source-position filename="ostree-repo.h" line="119"/>
+ <source-position filename="ostree-repo.h" line="120"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6240">bootloader configuration for the sysroot</doc>
+ line="6251">bootloader configuration for the sysroot</doc>
<type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6235">an #OstreeRepo</doc>
+ line="6246">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
</parameters>
version="2018.6">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6161">Get the collection ID of this repository. See [collection IDs][collection-ids].</doc>
- <source-position filename="ostree-repo.h" line="109"/>
+ line="6172">Get the collection ID of this repository. See [collection IDs][collection-ids].</doc>
+ <source-position filename="ostree-repo.h" line="110"/>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6167">collection ID for the repository</doc>
+ line="6178">collection ID for the repository</doc>
<type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6163">an #OstreeRepo</doc>
+ line="6174">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
</parameters>
</method>
<method name="get_config" c:identifier="ostree_repo_get_config">
- <source-position filename="ostree-repo.h" line="141"/>
+ <source-position filename="ostree-repo.h" line="142"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
version="2018.9">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6214">Get the set of default repo finders configured. See the documentation for
+ line="6225">Get the set of default repo finders configured. See the documentation for
the "core.default-repo-finders" config key.</doc>
- <source-position filename="ostree-repo.h" line="116"/>
+ <source-position filename="ostree-repo.h" line="117"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6221">
+ line="6232">
%NULL-terminated array of strings.</doc>
<array c:type="const gchar* const*">
<type name="utf8"/>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6216">an #OstreeRepo</doc>
+ line="6227">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
</parameters>
directly; for example, writing content into `repo/tmp` ensures it's
on the same filesystem. Another case is detecting the mtime on the
repository (to see whether a ref was written).</doc>
- <source-position filename="ostree-repo.h" line="125"/>
+ <source-position filename="ostree-repo.h" line="126"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
<doc xml:space="preserve"
filename="ostree-repo.c"
line="3406">For more information see ostree_repo_set_disable_fsync().</doc>
- <source-position filename="ostree-repo.h" line="86"/>
+ <source-position filename="ostree-repo.h" line="87"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
to the repo config and return that number in @out_reserved_bytes. See the
documentation for the core.min-free-space-size and
core.min-free-space-percent repo config options.</doc>
- <source-position filename="ostree-repo.h" line="137"/>
+ <source-position filename="ostree-repo.h" line="138"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
</parameters>
</method>
<method name="get_mode" c:identifier="ostree_repo_get_mode">
- <source-position filename="ostree-repo.h" line="134"/>
+ <source-position filename="ostree-repo.h" line="135"/>
<return-value transfer-ownership="none">
<type name="RepoMode" c:type="OstreeRepoMode"/>
</return-value>
filename="ostree-repo.c"
line="3568">Before this function can be used, ostree_repo_init() must have been
called.</doc>
- <source-position filename="ostree-repo.h" line="244"/>
+ <source-position filename="ostree-repo.h" line="245"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
line="3437">Note that since the introduction of ostree_repo_open_at(), this function may
return a process-specific path in `/proc` if the repository was created using
that API. In general, you should avoid use of this API.</doc>
- <source-position filename="ostree-repo.h" line="122"/>
+ <source-position filename="ostree-repo.h" line="123"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
underneath that group, and returns it as a boolean.
If the option is not set, @out_value will be set to @default_value. If an
error is returned, @out_value will be set to %FALSE.</doc>
- <source-position filename="ostree-repo.h" line="218"/>
+ <source-position filename="ostree-repo.h" line="219"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
underneath that group, and returns it as a zero terminated array of strings.
If the option is not set, or if an error is returned, @out_value will be set
to %NULL.</doc>
- <source-position filename="ostree-repo.h" line="211"/>
+ <source-position filename="ostree-repo.h" line="212"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
`[remote "remotename"]`. This function returns a value named @option_name
underneath that group, or @default_value if the remote exists but not the
option name. If an error is returned, @out_value will be set to %NULL.</doc>
- <source-position filename="ostree-repo.h" line="203"/>
+ <source-position filename="ostree-repo.h" line="204"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
The @remote_name parameter can be %NULL. In that case it will do
the verifications using GPG keys in the keyrings of all remotes.</doc>
- <source-position filename="ostree-repo.h" line="1397"/>
+ <source-position filename="ostree-repo.h" line="1413"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="4192">Set @out_have_object to %TRUE if @self contains the given object;
%FALSE otherwise.</doc>
- <source-position filename="ostree-repo.h" line="385"/>
+ <source-position filename="ostree-repo.h" line="386"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
the repository is open and the inode of its root directory has been loaded.
This function does no I/O.</doc>
- <source-position filename="ostree-repo.h" line="128"/>
+ <source-position filename="ostree-repo.h" line="129"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo-libarchive.c"
line="809">Import an archive file @archive into the repository, and write its
file structure to @mtree.</doc>
- <source-position filename="ostree-repo.h" line="793"/>
+ <source-position filename="ostree-repo.h" line="794"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
hard link operation.
Otherwise, a copy will be performed.</doc>
- <source-position filename="ostree-repo.h" line="590"/>
+ <source-position filename="ostree-repo.h" line="591"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
this will simply be a fast Unix hard link operation.
Otherwise, a copy will be performed.</doc>
- <source-position filename="ostree-repo.h" line="597"/>
+ <source-position filename="ostree-repo.h" line="598"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
</parameters>
</method>
<method name="is_system" c:identifier="ostree_repo_is_system">
- <source-position filename="ostree-repo.h" line="89"/>
+ <source-position filename="ostree-repo.h" line="90"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="1385">Returns whether the repository is writable by the current user.
If the repository is not writable, the @error indicates why.</doc>
- <source-position filename="ostree-repo.h" line="92"/>
+ <source-position filename="ostree-repo.h" line="93"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
%OSTREE_REPO_LIST_REFS_EXT_EXCLUDE_REMOTES in @flags. Similarly use
%OSTREE_REPO_LIST_REFS_EXT_EXCLUDE_MIRRORS to exclude refs from
`refs/mirrors`.</doc>
- <source-position filename="ostree-repo.h" line="1309"/>
+ <source-position filename="ostree-repo.h" line="1325"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-refs.c"
filename="ostree-repo.c"
line="4599">This function synchronously enumerates all commit objects starting
with @start, returning data in @out_commits.</doc>
- <source-position filename="ostree-repo.h" line="1036"/>
+ <source-position filename="ostree-repo.h" line="1037"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
repository, returning data in @out_objects. @out_objects
maps from keys returned by ostree_object_name_serialize()
to #GVariant values of type %OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE.</doc>
- <source-position filename="ostree-repo.h" line="1029"/>
+ <source-position filename="ostree-repo.h" line="1030"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
@out_all_refs will be returned as a mapping from refspecs (including the
remote name) to checksums. If @refspec_prefix is non-%NULL, it will be
removed as a prefix from the hash table keys.</doc>
- <source-position filename="ostree-repo.h" line="500"/>
+ <source-position filename="ostree-repo.h" line="501"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@out_all_refs will be returned as a mapping from refspecs (including the
remote name) to checksums. Differently from ostree_repo_list_refs(), the
@refspec_prefix will not be removed from the refspecs in the hash table.</doc>
- <source-position filename="ostree-repo.h" line="521"/>
+ <source-position filename="ostree-repo.h" line="522"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="58">This function synchronously enumerates all static deltas in the
+ line="80">This function synchronously enumerates all static deltas in the
repository, returning its result in @out_deltas.</doc>
- <source-position filename="ostree-repo.h" line="1043"/>
+ <source-position filename="ostree-repo.h" line="1044"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="60">Repo</doc>
+ line="82">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="out_deltas"
transfer-ownership="container">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="61">String name of deltas (checksum-checksum.delta)</doc>
+ line="83">String name of deltas (checksum-checksum.delta)</doc>
<array name="GLib.PtrArray" c:type="GPtrArray**">
<type name="utf8"/>
</array>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="62">Cancellable</doc>
+ line="84">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
capable of returning extended state information. Currently
the only extended state is %OSTREE_REPO_COMMIT_STATE_PARTIAL, which
means that only a sub-path of the commit is available.</doc>
- <source-position filename="ostree-repo.h" line="557"/>
+ <source-position filename="ostree-repo.h" line="558"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="4031">Load content object, decomposing it into three parts: the actual
content (for regular files), the metadata, and extended attributes.</doc>
- <source-position filename="ostree-repo.h" line="564"/>
+ <source-position filename="ostree-repo.h" line="565"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="4092">Load object as a stream; useful when copying objects between
repositories.</doc>
- <source-position filename="ostree-repo.h" line="573"/>
+ <source-position filename="ostree-repo.h" line="574"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="4499">Load the metadata object @sha256 of type @objtype, storing the
result in @out_variant.</doc>
- <source-position filename="ostree-repo.h" line="543"/>
+ <source-position filename="ostree-repo.h" line="544"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="4476">Attempt to load the metadata object @sha256 of type @objtype if it
exists, storing the result in @out_variant. If it doesn't exist,
%NULL is returned.</doc>
- <source-position filename="ostree-repo.h" line="550"/>
+ <source-position filename="ostree-repo.h" line="551"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
This function is used by ostree_repo_pull_with_options(); you
should use this if you are implementing a different type of transport.</doc>
- <source-position filename="ostree-repo.h" line="333"/>
+ <source-position filename="ostree-repo.h" line="334"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
fsck operations to exit properly with an error code if the
repository has been truncated as a result of fsck trying to repair
it.</doc>
- <source-position filename="ostree-repo.h" line="339"/>
+ <source-position filename="ostree-repo.h" line="340"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
</parameters>
</method>
<method name="open" c:identifier="ostree_repo_open" throws="1">
- <source-position filename="ostree-repo.h" line="63"/>
+ <source-position filename="ostree-repo.h" line="64"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
Locking: Acquires a `shared` lock; release via commit or abort
Multithreading: This function is *not* MT safe; only one transaction can be
active at a time.</doc>
- <source-position filename="ostree-repo.h" line="316"/>
+ <source-position filename="ostree-repo.h" line="317"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
deleting them.
Locking: exclusive</doc>
- <source-position filename="ostree-repo.h" line="1189"/>
+ <source-position filename="ostree-repo.h" line="1205"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
statistics on objects that would be deleted, without actually deleting them.
Locking: exclusive</doc>
- <source-position filename="ostree-repo.h" line="1221"/>
+ <source-position filename="ostree-repo.h" line="1237"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
deleted.
Locking: exclusive</doc>
- <source-position filename="ostree-repo.h" line="1184"/>
+ <source-position filename="ostree-repo.h" line="1200"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
which is a bug, but kept for compatibility reasons. If you want to
avoid this, use g_main_context_push_thread_default() to push a new
one around this call.</doc>
- <source-position filename="ostree-repo.h" line="1248"/>
+ <source-position filename="ostree-repo.h" line="1264"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
version="2018.6">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5778">Pull refs from multiple remotes which have been found using
+ line="5791">Pull refs from multiple remotes which have been found using
ostree_repo_find_remotes_async().
@results are expected to be in priority order, with the best remotes to pull
not being pulled will be ignored and any ref without a keyring remote
will be verified with the keyring of the remote being pulled from.
Since: 2019.2</doc>
- <source-position filename="ostree-repo.h" line="1290"/>
+ <source-position filename="ostree-repo.h" line="1306"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5780">an #OstreeRepo</doc>
+ line="5793">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="results" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5781">%NULL-terminated array of remotes to
+ line="5794">%NULL-terminated array of remotes to
pull from, including the refs to pull from each</doc>
<array c:type="const OstreeRepoFinderResult* const*">
<type name="RepoFinderResult" c:type="OstreeRepoFinderResult*"/>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5783">A GVariant `a{sv}` with an extensible set of flags</doc>
+ line="5796">A GVariant `a{sv}` with an extensible set of flags</doc>
<type name="GLib.Variant" c:type="GVariant*"/>
</parameter>
<parameter name="progress"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5784">an #OstreeAsyncProgress to update with the operation’s
+ line="5797">an #OstreeAsyncProgress to update with the operation’s
progress, or %NULL</doc>
<type name="AsyncProgress" c:type="OstreeAsyncProgress*"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5786">a #GCancellable, or %NULL</doc>
+ line="5799">a #GCancellable, or %NULL</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback"
closure="5">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5787">asynchronous completion callback</doc>
+ line="5800">asynchronous completion callback</doc>
<type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="5788">data to pass to @callback</doc>
+ line="5801">data to pass to @callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6031">Finish an asynchronous pull operation started with
+ line="6044">Finish an asynchronous pull operation started with
ostree_repo_pull_from_remotes_async().</doc>
- <source-position filename="ostree-repo.h" line="1298"/>
+ <source-position filename="ostree-repo.h" line="1314"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6040">%TRUE on success, %FALSE otherwise</doc>
+ line="6053">%TRUE on success, %FALSE otherwise</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6033">an #OstreeRepo</doc>
+ line="6046">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6034">the asynchronous result</doc>
+ line="6047">the asynchronous result</doc>
<type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
filename="ostree-repo.c"
line="4716">This is similar to ostree_repo_pull(), but only fetches a single
subpath.</doc>
- <source-position filename="ostree-repo.h" line="1258"/>
+ <source-position filename="ostree-repo.h" line="1274"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="3265">Like ostree_repo_pull(), but supports an extensible set of flags.
+ line="3294">Like ostree_repo_pull(), but supports an extensible set of flags.
The following are currently defined:
* `refs` (`as`): Array of string refs
specified, the `summary` will be downloaded from the remote. Since: 2020.5
* `summary-sig-bytes` (`ay`): Contents of the `summary.sig` file. If this
is specified, `summary-bytes` must also be specified. Since: 2020.5</doc>
- <source-position filename="ostree-repo.h" line="1268"/>
+ <source-position filename="ostree-repo.h" line="1284"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="3267">Repo</doc>
+ line="3296">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="remote_name_or_baseurl" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="3268">Name of remote or file:// url</doc>
+ line="3297">Name of remote or file:// url</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="3269">A GVariant a{sv} with an extensible set of flags.</doc>
+ line="3298">A GVariant a{sv} with an extensible set of flags.</doc>
<type name="GLib.Variant" c:type="GVariant*"/>
</parameter>
<parameter name="progress"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="3270">Progress</doc>
+ line="3299">Progress</doc>
<type name="AsyncProgress" c:type="OstreeAsyncProgress*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="3271">Cancellable</doc>
+ line="3300">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
filename="ostree-repo.c"
line="4440">Return the size in bytes of object with checksum @sha256, after any
compression has been applied.</doc>
- <source-position filename="ostree-repo.h" line="582"/>
+ <source-position filename="ostree-repo.h" line="583"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo.c"
line="4642">Load the content for @rev into @out_root.</doc>
- <source-position filename="ostree-repo.h" line="999"/>
+ <source-position filename="ostree-repo.h" line="1000"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="3085">OSTree commits can have arbitrary metadata associated; this
function retrieves them. If none exists, @out_metadata will be set
to %NULL.</doc>
- <source-position filename="ostree-repo.h" line="861"/>
+ <source-position filename="ostree-repo.h" line="862"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
lexicographic order.
Locking: exclusive</doc>
- <source-position filename="ostree-repo.h" line="1415"/>
+ <source-position filename="ostree-repo.h" line="1431"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="3213">By default, an #OstreeRepo will cache the remote configuration and its
own repo/config data. This API can be used to reload it.</doc>
- <source-position filename="ostree-repo.h" line="147"/>
+ <source-position filename="ostree-repo.h" line="148"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
* s: g_key_file_set_string()
* b: g_key_file_set_boolean()
* as: g_key_file_set_string_list()</doc>
- <source-position filename="ostree-repo.h" line="152"/>
+ <source-position filename="ostree-repo.h" line="153"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="1840">A combined function handling the equivalent of
ostree_repo_remote_add(), ostree_repo_remote_delete(), with more
options.</doc>
- <source-position filename="ostree-repo.h" line="183"/>
+ <source-position filename="ostree-repo.h" line="184"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="1738">Delete the remote named @name. It is an error if the provided
remote does not exist.</doc>
- <source-position filename="ostree-repo.h" line="160"/>
+ <source-position filename="ostree-repo.h" line="161"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
Parse the summary data into a #GVariant using g_variant_new_from_bytes()
with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string.</doc>
- <source-position filename="ostree-repo.h" line="227"/>
+ <source-position filename="ostree-repo.h" line="228"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6056">Like ostree_repo_remote_fetch_summary(), but supports an extensible set of flags.
+ line="6069">Like ostree_repo_remote_fetch_summary(), but supports an extensible set of flags.
The following are currently defined:
- override-url (s): Fetch summary from this URL if remote specifies no metalink in options
- n-network-retries (u): Number of times to retry each download on receiving
a transient network error, such as a socket timeout; default is 5, 0
means return errors without retrying</doc>
- <source-position filename="ostree-repo.h" line="235"/>
+ <source-position filename="ostree-repo.h" line="236"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6078">%TRUE on success, %FALSE on failure</doc>
+ line="6091">%TRUE on success, %FALSE on failure</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6058">Self</doc>
+ line="6071">Self</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6059">name of a remote</doc>
+ line="6072">name of a remote</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="options"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6060">A GVariant a{sv} with an extensible set of flags</doc>
+ line="6073">A GVariant a{sv} with an extensible set of flags</doc>
<type name="GLib.Variant" c:type="GVariant*"/>
</parameter>
<parameter name="out_summary"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6061">return location for raw summary data, or
+ line="6074">return location for raw summary data, or
%NULL</doc>
<type name="GLib.Bytes" c:type="GBytes**"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6063">return location for raw summary
+ line="6076">return location for raw summary
signature data, or %NULL</doc>
<type name="GLib.Bytes" c:type="GBytes**"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
- line="6065">a #GCancellable</doc>
+ line="6078">a #GCancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
line="2001">Return whether GPG verification is enabled for the remote named @name
through @out_gpg_verify. It is an error if the provided remote does
not exist.</doc>
- <source-position filename="ostree-repo.h" line="1347"/>
+ <source-position filename="ostree-repo.h" line="1363"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
line="2035">Return whether GPG verification of the summary is enabled for the remote
named @name through @out_gpg_verify_summary. It is an error if the provided
remote does not exist.</doc>
- <source-position filename="ostree-repo.h" line="1353"/>
+ <source-position filename="ostree-repo.h" line="1369"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="1958">Return the URL of the remote named @name through @out_url. It is an
error if the provided remote does not exist.</doc>
- <source-position filename="ostree-repo.h" line="197"/>
+ <source-position filename="ostree-repo.h" line="198"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
The imported keys will be used to conduct GPG verification when pulling
from the remote named @name.</doc>
- <source-position filename="ostree-repo.h" line="1358"/>
+ <source-position filename="ostree-repo.h" line="1374"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="1907">List available remote names in an #OstreeRepo. Remote names are sorted
alphabetically. If no remotes are available the function returns %NULL.</doc>
- <source-position filename="ostree-repo.h" line="193"/>
+ <source-position filename="ostree-repo.h" line="194"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
with a %NULL collection ID in each #OstreeCollectionRef key in @out_all_refs.
Any refs for other collections stored in the repository will also be returned.
No filtering is performed.</doc>
- <source-position filename="ostree-repo.h" line="536"/>
+ <source-position filename="ostree-repo.h" line="537"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<method name="remote_list_refs"
c:identifier="ostree_repo_remote_list_refs"
throws="1">
- <source-position filename="ostree-repo.h" line="529"/>
+ <source-position filename="ostree-repo.h" line="530"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
If you want to check only local refs, not remote or mirrored ones, use the
flag %OSTREE_REPO_RESOLVE_REV_EXT_LOCAL_ONLY. This is analogous to using
ostree_repo_resolve_rev_ext() but for collection-refs.</doc>
- <source-position filename="ostree-repo.h" line="491"/>
+ <source-position filename="ostree-repo.h" line="492"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-refs.c"
keyrings should match.
If no match can be found, a %G_IO_ERROR_NOT_FOUND error will be returned.</doc>
- <source-position filename="ostree-repo.h" line="1303"/>
+ <source-position filename="ostree-repo.h" line="1319"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo-pull.c"
line="447">Look up the given refspec, returning the checksum it references in
the parameter @out_rev. Will fall back on remote directory if cannot
find the given refspec in local.</doc>
- <source-position filename="ostree-repo.h" line="466"/>
+ <source-position filename="ostree-repo.h" line="467"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
The flag %OSTREE_REPO_RESOLVE_REV_EXT_LOCAL_ONLY is implied so
using it has no effect.</doc>
- <source-position filename="ostree-repo.h" line="483"/>
+ <source-position filename="ostree-repo.h" line="484"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
ostree_repo_devino_cache_new() is better as it avoids scanning all objects.
Multithreading: This function is *not* MT safe.</doc>
- <source-position filename="ostree-repo.h" line="311"/>
+ <source-position filename="ostree-repo.h" line="312"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
line="2311">Like ostree_repo_set_ref_immediate(), but creates an alias.</doc>
- <source-position filename="ostree-repo.h" line="370"/>
+ <source-position filename="ostree-repo.h" line="371"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
per-remote summary caches. Setting this manually is useful when
doing operations on a system repo as a user because you don't have
write permissions in the repo, where the cache is normally stored.</doc>
- <source-position filename="ostree-repo.h" line="79"/>
+ <source-position filename="ostree-repo.h" line="80"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6178">Set or clear the collection ID of this repository. See [collection IDs][collection-ids].
+ line="6189">Set or clear the collection ID of this repository. See [collection IDs][collection-ids].
The update will be made in memory, but must be written out to the repository
configuration on disk using ostree_repo_write_config().</doc>
- <source-position filename="ostree-repo.h" line="111"/>
+ <source-position filename="ostree-repo.h" line="112"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6188">%TRUE on success, %FALSE otherwise</doc>
+ line="6199">%TRUE on success, %FALSE otherwise</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6180">an #OstreeRepo</doc>
+ line="6191">an #OstreeRepo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="collection_id"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo.c"
- line="6181">new collection ID, or %NULL to unset it</doc>
+ line="6192">new collection ID, or %NULL to unset it</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
line="2337">This is like ostree_repo_transaction_set_collection_ref(), except it may be
invoked outside of a transaction. This is presently safe for the
case where we're creating or overwriting an existing ref.</doc>
- <source-position filename="ostree-repo.h" line="378"/>
+ <source-position filename="ostree-repo.h" line="379"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
option should only be used by build system tools which are creating
disposable virtual machines, or have higher level mechanisms for
ensuring data consistency.</doc>
- <source-position filename="ostree-repo.h" line="75"/>
+ <source-position filename="ostree-repo.h" line="76"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
case where we're creating or overwriting an existing ref.
Multithreading: This function is MT safe.</doc>
- <source-position filename="ostree-repo.h" line="362"/>
+ <source-position filename="ostree-repo.h" line="363"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo.c"
line="5044">Add a GPG signature to a commit.</doc>
- <source-position filename="ostree-repo.h" line="1321"/>
+ <source-position filename="ostree-repo.h" line="1337"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="5133">This function is deprecated, sign the summary file instead.
Add a GPG signature to a static delta.</doc>
- <source-position filename="ostree-repo.h" line="1329"/>
+ <source-position filename="ostree-repo.h" line="1345"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="191">Given a directory representing an already-downloaded static delta
+ line="543">Given a directory representing an already-downloaded static delta
on disk, apply it, generating a new commit. The directory must be
named with the form "FROM-TO", where both are checksums, and it
must contain a file named "superblock", along with at least one part.</doc>
- <source-position filename="ostree-repo.h" line="1071"/>
+ <source-position filename="ostree-repo.h" line="1080"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="193">Repo</doc>
+ line="545">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="dir_or_file" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="194">Path to a directory containing static delta data, or directly to the superblock</doc>
+ line="546">Path to a directory containing static delta data, or directly to the superblock</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<parameter name="skip_validation" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="195">If %TRUE, assume data integrity</doc>
+ line="547">If %TRUE, assume data integrity</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-core.c"
- line="196">Cancellable</doc>
+ line="548">Cancellable</doc>
+ <type name="Gio.Cancellable" c:type="GCancellable*"/>
+ </parameter>
+ </parameters>
+ </method>
+ <method name="static_delta_execute_offline_with_signature"
+ c:identifier="ostree_repo_static_delta_execute_offline_with_signature"
+ version="2020.7"
+ throws="1">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="303">Given a directory representing an already-downloaded static delta
+on disk, apply it, generating a new commit.
+If sign is passed, the static delta signature is verified.
+If sign-verify-deltas configuration option is set and static delta is signed,
+signature verification will be mandatory before apply the static delta.
+The directory must be named with the form "FROM-TO", where both are
+checksums, and it must contain a file named "superblock", along with at least
+one part.</doc>
+ <source-position filename="ostree-repo.h" line="1072"/>
+ <return-value transfer-ownership="none">
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="305">Repo</doc>
+ <type name="Repo" c:type="OstreeRepo*"/>
+ </instance-parameter>
+ <parameter name="dir_or_file" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="306">Path to a directory containing static delta data, or directly to the superblock</doc>
+ <type name="Gio.File" c:type="GFile*"/>
+ </parameter>
+ <parameter name="sign" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="307">Signature engine used to check superblock</doc>
+ <type name="Sign" c:type="OstreeSign*"/>
+ </parameter>
+ <parameter name="skip_validation" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="308">If %TRUE, assume data integrity</doc>
+ <type name="gboolean" c:type="gboolean"/>
+ </parameter>
+ <parameter name="cancellable"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="309">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1310">Generate a lookaside "static delta" from @from (%NULL means
+ line="1312">Generate a lookaside "static delta" from @from (%NULL means
from-empty) which can generate the objects in @to. This delta is
an optimization over fetching individual objects, and can be
conveniently stored and applied offline.
- inline-parts: b: Put part data in header, to get a single file delta. Default FALSE.
- verbose: b: Print diagnostic messages. Default FALSE.
- endianness: b: Deltas use host byte order by default; this option allows choosing (G_BIG_ENDIAN or G_LITTLE_ENDIAN)
- - filename: ay: Save delta superblock to this filename, and parts in the same directory. Default saves to repository.</doc>
- <source-position filename="ostree-repo.h" line="1061"/>
+ - filename: ay: Save delta superblock to this filename, and parts in the same directory. Default saves to repository.
+ - sign-name: ay: Signature type to use.
+ - sign-key-ids: as: Array of keys used to sign delta superblock.</doc>
+ <source-position filename="ostree-repo.h" line="1062"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1312">Repo</doc>
+ line="1314">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="opt" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1313">High level optimization choice</doc>
+ line="1315">High level optimization choice</doc>
<type name="StaticDeltaGenerateOpt"
c:type="OstreeStaticDeltaGenerateOpt"/>
</parameter>
<parameter name="from" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1314">ASCII SHA256 checksum of origin, or %NULL</doc>
+ line="1316">ASCII SHA256 checksum of origin, or %NULL</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="to" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1315">ASCII SHA256 checksum of target</doc>
+ line="1317">ASCII SHA256 checksum of target</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="metadata"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1316">Optional metadata</doc>
+ line="1318">Optional metadata</doc>
<type name="GLib.Variant" c:type="GVariant*"/>
</parameter>
<parameter name="params"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1317">Parameters, see below</doc>
+ line="1319">Parameters, see below</doc>
<type name="GLib.Variant" c:type="GVariant*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-static-delta-compilation.c"
- line="1318">Cancellable</doc>
+ line="1320">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</method>
+ <method name="static_delta_verify_signature"
+ c:identifier="ostree_repo_static_delta_verify_signature"
+ version="2020.7"
+ throws="1">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="1074">Verify static delta file signature.</doc>
+ <source-position filename="ostree-repo.h" line="1087"/>
+ <return-value transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="1084">TRUE if the signature of static delta file is valid using the
+signature engine provided, FALSE otherwise.</doc>
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="1076">Repo</doc>
+ <type name="Repo" c:type="OstreeRepo*"/>
+ </instance-parameter>
+ <parameter name="delta_id" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="1077">delta path</doc>
+ <type name="utf8" c:type="const char*"/>
+ </parameter>
+ <parameter name="sign" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="1078">Signature engine used to check superblock</doc>
+ <type name="Sign" c:type="OstreeSign*"/>
+ </parameter>
+ <parameter name="out_success_message" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-repo-static-delta-core.c"
+ line="1079">success message</doc>
+ <type name="utf8" c:type="char**"/>
+ </parameter>
+ </parameters>
+ </method>
<method name="transaction_set_collection_ref"
c:identifier="ostree_repo_transaction_set_collection_ref"
version="2018.6">
be made to the repository.
Multithreading: Since v2017.15 this function is MT safe.</doc>
- <source-position filename="ostree-repo.h" line="357"/>
+ <source-position filename="ostree-repo.h" line="358"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
case.
Multithreading: Since v2017.15 this function is MT safe.</doc>
- <source-position filename="ostree-repo.h" line="351"/>
+ <source-position filename="ostree-repo.h" line="352"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
arguments.
Multithreading: Since v2017.15 this function is MT safe.</doc>
- <source-position filename="ostree-repo.h" line="346"/>
+ <source-position filename="ostree-repo.h" line="347"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
filename="ostree-repo-traverse.c"
line="665">Create a new set @out_reachable containing all objects reachable
from @commit_checksum, traversing @maxdepth parent commits.</doc>
- <source-position filename="ostree-repo.h" line="1087"/>
+ <source-position filename="ostree-repo.h" line="1103"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-traverse.c"
line="639">Update the set @inout_reachable containing all objects reachable
from @commit_checksum, traversing @maxdepth parent commits.</doc>
- <source-position filename="ostree-repo.h" line="1095"/>
+ <source-position filename="ostree-repo.h" line="1111"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
Additionally this constructs a mapping from each object to the parents
of the object, which can be used to track which commits an object
belongs to.</doc>
- <source-position filename="ostree-repo.h" line="1102"/>
+ <source-position filename="ostree-repo.h" line="1118"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="307">Add all commit objects directly reachable via a ref to @reachable.
Locking: shared</doc>
- <source-position filename="ostree-repo.h" line="1214"/>
+ <source-position filename="ostree-repo.h" line="1230"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo.c"
line="5461">Check for a valid GPG signature on commit named by the ASCII
checksum @commit_checksum.</doc>
- <source-position filename="ostree-repo.h" line="1339"/>
+ <source-position filename="ostree-repo.h" line="1355"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="5499">Read GPG signature(s) on the commit named by the ASCII checksum
@commit_checksum and return detailed results.</doc>
- <source-position filename="ostree-repo.h" line="1381"/>
+ <source-position filename="ostree-repo.h" line="1397"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
line="5535">Read GPG signature(s) on the commit named by the ASCII checksum
@commit_checksum and return detailed results, based on the keyring
configured for @remote.</doc>
- <source-position filename="ostree-repo.h" line="1390"/>
+ <source-position filename="ostree-repo.h" line="1406"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo.c"
line="5622">Verify @signatures for @summary data using GPG keys in the keyring for
@remote_name, and return an #OstreeGpgVerifyResult.</doc>
- <source-position filename="ostree-repo.h" line="1407"/>
+ <source-position filename="ostree-repo.h" line="1423"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo.c"
filename="ostree-repo-libarchive.c"
line="937">Import an archive file @archive into the repository, and write its
file structure to @mtree.</doc>
- <source-position filename="ostree-repo.h" line="729"/>
+ <source-position filename="ostree-repo.h" line="730"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-libarchive.c"
line="972">Read an archive from @fd and import it into the repository, writing
its file structure to @mtree.</doc>
- <source-position filename="ostree-repo.h" line="739"/>
+ <source-position filename="ostree-repo.h" line="740"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-commit.c"
line="2999">Write a commit metadata object, referencing @root_contents_checksum
and @root_metadata_checksum.</doc>
- <source-position filename="ostree-repo.h" line="838"/>
+ <source-position filename="ostree-repo.h" line="839"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="3133">Replace any existing metadata associated with commit referred to by
@checksum with @metadata. If @metadata is %NULL, then existing
data will be deleted.</doc>
- <source-position filename="ostree-repo.h" line="868"/>
+ <source-position filename="ostree-repo.h" line="869"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-commit.c"
line="3031">Write a commit metadata object, referencing @root_contents_checksum
and @root_metadata_checksum.</doc>
- <source-position filename="ostree-repo.h" line="849"/>
+ <source-position filename="ostree-repo.h" line="850"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo.c"
line="1464">Save @new_config in place of this repository's config file.</doc>
- <source-position filename="ostree-repo.h" line="247"/>
+ <source-position filename="ostree-repo.h" line="248"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
line="2824">Store the content object streamed as @object_input,
with total length @length. The actual checksum will
be returned as @out_csum.</doc>
- <source-position filename="ostree-repo.h" line="417"/>
+ <source-position filename="ostree-repo.h" line="418"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-commit.c"
line="2922">Asynchronously store the content object @object. If provided, the
checksum @expected_checksum will be verified.</doc>
- <source-position filename="ostree-repo.h" line="451"/>
+ <source-position filename="ostree-repo.h" line="452"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
line="2963">Completes an invocation of ostree_repo_write_content_async().</doc>
- <source-position filename="ostree-repo.h" line="460"/>
+ <source-position filename="ostree-repo.h" line="461"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
This function should be used when importing file objects from local
disk, for example.</doc>
- <source-position filename="ostree-repo.h" line="443"/>
+ <source-position filename="ostree-repo.h" line="444"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4091">Store as objects all contents of the directory referred to by @dfd
+ line="4088">Store as objects all contents of the directory referred to by @dfd
and @path all children into the repository @self, overlaying the
resulting filesystem hierarchy into @mtree.</doc>
- <source-position filename="ostree-repo.h" line="719"/>
+ <source-position filename="ostree-repo.h" line="720"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4093">Repo</doc>
+ line="4090">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="dfd" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4094">Directory file descriptor</doc>
+ line="4091">Directory file descriptor</doc>
<type name="gint" c:type="int"/>
</parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4095">Path</doc>
+ line="4092">Path</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="mtree" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4096">Overlay directory contents into this tree</doc>
+ line="4093">Overlay directory contents into this tree</doc>
<type name="MutableTree" c:type="OstreeMutableTree*"/>
</parameter>
<parameter name="modifier"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4097">Optional modifier</doc>
+ line="4094">Optional modifier</doc>
<type name="RepoCommitModifier"
c:type="OstreeRepoCommitModifier*"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4098">Cancellable</doc>
+ line="4095">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4050">Store objects for @dir and all children into the repository @self,
+ line="4047">Store objects for @dir and all children into the repository @self,
overlaying the resulting filesystem hierarchy into @mtree.</doc>
- <source-position filename="ostree-repo.h" line="711"/>
+ <source-position filename="ostree-repo.h" line="712"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4052">Repo</doc>
+ line="4049">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="dir" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4053">Path to a directory</doc>
+ line="4050">Path to a directory</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<parameter name="mtree" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4054">Overlay directory contents into this tree</doc>
+ line="4051">Overlay directory contents into this tree</doc>
<type name="MutableTree" c:type="OstreeMutableTree*"/>
</parameter>
<parameter name="modifier"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4055">Optional modifier</doc>
+ line="4052">Optional modifier</doc>
<type name="RepoCommitModifier"
c:type="OstreeRepoCommitModifier*"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4056">Cancellable</doc>
+ line="4053">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
If @expected_checksum is not %NULL, verify it against the
computed checksum.</doc>
- <source-position filename="ostree-repo.h" line="393"/>
+ <source-position filename="ostree-repo.h" line="394"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-commit.c"
line="2706">Asynchronously store the metadata object @variant. If provided,
the checksum @expected_checksum will be verified.</doc>
- <source-position filename="ostree-repo.h" line="402"/>
+ <source-position filename="ostree-repo.h" line="403"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
line="2747">Complete a call to ostree_repo_write_metadata_async().</doc>
- <source-position filename="ostree-repo.h" line="411"/>
+ <source-position filename="ostree-repo.h" line="412"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-commit.c"
line="2604">Store the metadata object @variant; the provided @checksum is
trusted.</doc>
- <source-position filename="ostree-repo.h" line="434"/>
+ <source-position filename="ostree-repo.h" line="435"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
filename="ostree-repo-commit.c"
line="2641">Store the metadata object @variant; the provided @checksum is
trusted.</doc>
- <source-position filename="ostree-repo.h" line="426"/>
+ <source-position filename="ostree-repo.h" line="427"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4141">Write all metadata objects for @mtree to repo; the resulting
+ line="4138">Write all metadata objects for @mtree to repo; the resulting
@out_file points to the %OSTREE_OBJECT_TYPE_DIR_TREE object that
the @mtree represented.</doc>
- <source-position filename="ostree-repo.h" line="831"/>
+ <source-position filename="ostree-repo.h" line="832"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4143">Repo</doc>
+ line="4140">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</instance-parameter>
<parameter name="mtree" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4144">Mutable tree</doc>
+ line="4141">Mutable tree</doc>
<type name="MutableTree" c:type="OstreeMutableTree*"/>
</parameter>
<parameter name="out_file"
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4145">An #OstreeRepoFile representing @mtree's root.</doc>
+ line="4142">An #OstreeRepoFile representing @mtree's root.</doc>
<type name="Gio.File" c:type="GFile**"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4146">Cancellable</doc>
+ line="4143">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
<record name="RepoCheckoutAtOptions" c:type="OstreeRepoCheckoutAtOptions">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="937">An extensible options structure controlling checkout. Ensure that
+ line="938">An extensible options structure controlling checkout. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_checkout_at() which
supercedes previous separate enumeration usage in
ostree_repo_checkout_tree() and ostree_repo_checkout_tree_at().</doc>
- <source-position filename="ostree-repo.h" line="970"/>
+ <source-position filename="ostree-repo.h" line="971"/>
<field name="mode" writable="1">
<type name="RepoCheckoutMode" c:type="OstreeRepoCheckoutMode"/>
</field>
version="2017.13">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1388">This function simply assigns @cache to the `devino_to_csum_cache` member of
+ line="1404">This function simply assigns @cache to the `devino_to_csum_cache` member of
@opts; it's only useful for introspection.
Note that cache does *not* have its refcount incremented - the lifetime of
@cache must be equal to or greater than that of @opts.</doc>
- <source-position filename="ostree-repo.h" line="982"/>
+ <source-position filename="ostree-repo.h" line="983"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="opts" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1390">Checkout options</doc>
+ line="1406">Checkout options</doc>
<type name="RepoCheckoutAtOptions"
c:type="OstreeRepoCheckoutAtOptions*"/>
</instance-parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1391">Devino cache</doc>
+ line="1407">Devino cache</doc>
<type name="RepoDevInoCache" c:type="OstreeRepoDevInoCache*"/>
</parameter>
</parameters>
<callback name="RepoCheckoutFilter"
c:type="OstreeRepoCheckoutFilter"
version="2018.2">
- <source-position filename="ostree-repo.h" line="932"/>
+ <source-position filename="ostree-repo.h" line="933"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="928">#OstreeRepoCheckoutFilterResult saying whether or not to checkout this file</doc>
+ line="929">#OstreeRepoCheckoutFilterResult saying whether or not to checkout this file</doc>
<type name="RepoCheckoutFilterResult"
c:type="OstreeRepoCheckoutFilterResult"/>
</return-value>
<parameter name="repo" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="923">Repo</doc>
+ line="924">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="924">Path to file</doc>
+ line="925">Path to file</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="stbuf"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="925">File information</doc>
+ line="926">File information</doc>
<type name="gpointer" c:type="stat*"/>
</parameter>
<parameter name="user_data"
closure="3">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="926">User data</doc>
+ line="927">User data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
<enumeration name="RepoCheckoutFilterResult"
version="2018.2"
c:type="OstreeRepoCheckoutFilterResult">
- <source-position filename="ostree-repo.h" line="919"/>
+ <source-position filename="ostree-repo.h" line="920"/>
<member name="allow"
value="0"
c:identifier="OSTREE_REPO_CHECKOUT_FILTER_ALLOW">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="911">Do checkout this object</doc>
+ line="912">Do checkout this object</doc>
</member>
<member name="skip"
value="1"
c:identifier="OSTREE_REPO_CHECKOUT_FILTER_SKIP">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="912">Ignore this object</doc>
+ line="913">Ignore this object</doc>
</member>
</enumeration>
<enumeration name="RepoCheckoutMode" c:type="OstreeRepoCheckoutMode">
- <source-position filename="ostree-repo.h" line="882"/>
+ <source-position filename="ostree-repo.h" line="883"/>
<member name="none"
value="0"
c:identifier="OSTREE_REPO_CHECKOUT_MODE_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="876">No special options</doc>
+ line="877">No special options</doc>
</member>
<member name="user"
value="1"
c:identifier="OSTREE_REPO_CHECKOUT_MODE_USER">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="877">Ignore uid/gid of files</doc>
+ line="878">Ignore uid/gid of files</doc>
</member>
</enumeration>
<record name="RepoCheckoutOptions"
</record>
<enumeration name="RepoCheckoutOverwriteMode"
c:type="OstreeRepoCheckoutOverwriteMode">
- <source-position filename="ostree-repo.h" line="896"/>
+ <source-position filename="ostree-repo.h" line="897"/>
<member name="none"
value="0"
c:identifier="OSTREE_REPO_CHECKOUT_OVERWRITE_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="886">No special options</doc>
+ line="887">No special options</doc>
</member>
<member name="union_files"
value="1"
c:identifier="OSTREE_REPO_CHECKOUT_OVERWRITE_UNION_FILES">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="887">When layering checkouts, unlink() and replace existing files, but do not modify existing directories (unless whiteouts are enabled, then directories are replaced)</doc>
+ line="888">When layering checkouts, unlink() and replace existing files, but do not modify existing directories (unless whiteouts are enabled, then directories are replaced)</doc>
</member>
<member name="add_files"
value="2"
c:identifier="OSTREE_REPO_CHECKOUT_OVERWRITE_ADD_FILES">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="888">Only add new files/directories</doc>
+ line="889">Only add new files/directories</doc>
</member>
<member name="union_identical"
value="3"
c:identifier="OSTREE_REPO_CHECKOUT_OVERWRITE_UNION_IDENTICAL">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="889">Like UNION_FILES, but error if files are not identical (requires hardlink checkouts)</doc>
+ line="890">Like UNION_FILES, but error if files are not identical (requires hardlink checkouts)</doc>
</member>
</enumeration>
<callback name="RepoCommitFilter" c:type="OstreeRepoCommitFilter">
- <source-position filename="ostree-repo.h" line="638"/>
+ <source-position filename="ostree-repo.h" line="639"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="636">#OstreeRepoCommitFilterResult saying whether or not to commit this file</doc>
+ line="637">#OstreeRepoCommitFilterResult saying whether or not to commit this file</doc>
<type name="RepoCommitFilterResult"
c:type="OstreeRepoCommitFilterResult"/>
</return-value>
<parameter name="repo" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="631">Repo</doc>
+ line="632">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="632">Path to file</doc>
+ line="633">Path to file</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="file_info" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="633">File information</doc>
+ line="634">File information</doc>
<type name="Gio.FileInfo" c:type="GFileInfo*"/>
</parameter>
<parameter name="user_data"
closure="3">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="634">User data</doc>
+ line="635">User data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
<enumeration name="RepoCommitFilterResult"
c:type="OstreeRepoCommitFilterResult">
- <source-position filename="ostree-repo.h" line="627"/>
+ <source-position filename="ostree-repo.h" line="628"/>
<member name="allow"
value="0"
c:identifier="OSTREE_REPO_COMMIT_FILTER_ALLOW">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="621">Do commit this object</doc>
+ line="622">Do commit this object</doc>
</member>
<member name="skip"
value="1"
c:identifier="OSTREE_REPO_COMMIT_FILTER_SKIP">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="622">Ignore this object</doc>
+ line="623">Ignore this object</doc>
</member>
</enumeration>
<enumeration name="RepoCommitIterResult"
c:type="OstreeRepoCommitIterResult">
- <source-position filename="ostree-repo.h" line="1144"/>
+ <source-position filename="ostree-repo.h" line="1160"/>
<member name="error"
value="0"
c:identifier="OSTREE_REPO_COMMIT_ITER_RESULT_ERROR">
c:symbol-prefix="repo_commit_modifier">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="663">A structure allowing control over commits.</doc>
- <source-position filename="ostree-repo.h" line="668"/>
+ line="664">A structure allowing control over commits.</doc>
+ <source-position filename="ostree-repo.h" line="669"/>
<constructor name="new" c:identifier="ostree_repo_commit_modifier_new">
- <source-position filename="ostree-repo.h" line="671"/>
+ <source-position filename="ostree-repo.h" line="672"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4229">A new commit modifier.</doc>
+ line="4226">A new commit modifier.</doc>
<type name="RepoCommitModifier" c:type="OstreeRepoCommitModifier*"/>
</return-value>
<parameters>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4224">Control options for filter</doc>
+ line="4221">Control options for filter</doc>
<type name="RepoCommitModifierFlags"
c:type="OstreeRepoCommitModifierFlags"/>
</parameter>
destroy="3">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4225">Function that can inspect individual files</doc>
+ line="4222">Function that can inspect individual files</doc>
<type name="RepoCommitFilter" c:type="OstreeRepoCommitFilter"/>
</parameter>
<parameter name="user_data"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4226">User data</doc>
+ line="4223">User data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="destroy_notify"
scope="async">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4227">A #GDestroyNotify</doc>
+ line="4224">A #GDestroyNotify</doc>
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
</parameters>
</constructor>
<method name="ref" c:identifier="ostree_repo_commit_modifier_ref">
- <source-position filename="ostree-repo.h" line="706"/>
+ <source-position filename="ostree-repo.h" line="707"/>
<return-value transfer-ownership="full">
<type name="RepoCommitModifier" c:type="OstreeRepoCommitModifier*"/>
</return-value>
version="2017.13">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4380">See the documentation for
+ line="4377">See the documentation for
`ostree_repo_devino_cache_new()`. This function can
then be used for later calls to
`ostree_repo_write_directory_to_mtree()` to optimize commits.
This function will add a reference to @cache without copying - you
should avoid further mutation of the cache.</doc>
- <source-position filename="ostree-repo.h" line="702"/>
+ <source-position filename="ostree-repo.h" line="703"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="modifier" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4382">Modifier</doc>
+ line="4379">Modifier</doc>
<type name="RepoCommitModifier"
c:type="OstreeRepoCommitModifier*"/>
</instance-parameter>
<parameter name="cache" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4383">A hash table caching device,inode to checksums</doc>
+ line="4380">A hash table caching device,inode to checksums</doc>
<type name="RepoDevInoCache" c:type="OstreeRepoDevInoCache*"/>
</parameter>
</parameters>
c:identifier="ostree_repo_commit_modifier_set_sepolicy">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4302">If @policy is non-%NULL, use it to look up labels to use for
+ line="4299">If @policy is non-%NULL, use it to look up labels to use for
"security.selinux" extended attributes.
Note that any policy specified this way operates in addition to any
ostree_repo_commit_modifier_set_xattr_callback(). However if both
specify a value for "security.selinux", then the one from the
policy wins.</doc>
- <source-position filename="ostree-repo.h" line="691"/>
+ <source-position filename="ostree-repo.h" line="692"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="modifier" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4304">An #OstreeRepoCommitModifier</doc>
+ line="4301">An #OstreeRepoCommitModifier</doc>
<type name="RepoCommitModifier"
c:type="OstreeRepoCommitModifier*"/>
</instance-parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4305">Policy to use for labeling</doc>
+ line="4302">Policy to use for labeling</doc>
<type name="SePolicy" c:type="OstreeSePolicy*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4324">In many cases, one wants to create a "derived" commit from base commit.
+ line="4321">In many cases, one wants to create a "derived" commit from base commit.
SELinux policy labels are part of that base commit. This API allows
one to easily set up SELinux labeling from a base commit.</doc>
- <source-position filename="ostree-repo.h" line="695"/>
+ <source-position filename="ostree-repo.h" line="696"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="modifier" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4326">Commit modifier</doc>
+ line="4323">Commit modifier</doc>
<type name="RepoCommitModifier"
c:type="OstreeRepoCommitModifier*"/>
</instance-parameter>
<parameter name="repo" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4327">OSTree repo containing @rev</doc>
+ line="4324">OSTree repo containing @rev</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</parameter>
<parameter name="rev" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4328">Find SELinux policy from this base commit</doc>
+ line="4325">Find SELinux policy from this base commit</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable"
c:identifier="ostree_repo_commit_modifier_set_xattr_callback">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4279">If set, this function should return extended attributes to use for
+ line="4276">If set, this function should return extended attributes to use for
the given path. This is useful for things like ACLs and SELinux,
where a build system can label the files as it's committing to the
repository.</doc>
- <source-position filename="ostree-repo.h" line="685"/>
+ <source-position filename="ostree-repo.h" line="686"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="modifier" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4281">An #OstreeRepoCommitModifier</doc>
+ line="4278">An #OstreeRepoCommitModifier</doc>
<type name="RepoCommitModifier"
c:type="OstreeRepoCommitModifier*"/>
</instance-parameter>
destroy="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4282">Function to be invoked, should return extended attributes for path</doc>
+ line="4279">Function to be invoked, should return extended attributes for path</doc>
<type name="RepoCommitModifierXattrCallback"
c:type="OstreeRepoCommitModifierXattrCallback"/>
</parameter>
<parameter name="destroy" transfer-ownership="none" scope="async">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4283">Destroy notification</doc>
+ line="4280">Destroy notification</doc>
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
<parameter name="user_data"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo-commit.c"
- line="4284">Data for @callback:</doc>
+ line="4281">Data for @callback:</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</method>
<method name="unref" c:identifier="ostree_repo_commit_modifier_unref">
- <source-position filename="ostree-repo.h" line="708"/>
+ <source-position filename="ostree-repo.h" line="709"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
</record>
<bitfield name="RepoCommitModifierFlags"
c:type="OstreeRepoCommitModifierFlags">
- <source-position filename="ostree-repo.h" line="661"/>
+ <source-position filename="ostree-repo.h" line="662"/>
<member name="none"
value="0"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="645">No special flags</doc>
+ line="646">No special flags</doc>
</member>
<member name="skip_xattrs"
value="1"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_SKIP_XATTRS">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="646">Do not process extended attributes</doc>
+ line="647">Do not process extended attributes</doc>
</member>
<member name="generate_sizes"
value="2"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_GENERATE_SIZES">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="647">Generate size information.</doc>
+ line="648">Generate size information.</doc>
</member>
<member name="canonical_permissions"
value="4"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_CANONICAL_PERMISSIONS">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="648">Canonicalize permissions for bare-user-only mode.</doc>
+ line="649">Canonicalize permissions for bare-user-only mode.</doc>
</member>
<member name="error_on_unlabeled"
value="8"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_ERROR_ON_UNLABELED">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="649">Emit an error if configured SELinux policy does not provide a label</doc>
+ line="650">Emit an error if configured SELinux policy does not provide a label</doc>
</member>
<member name="consume"
value="16"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_CONSUME">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="650">Delete added files/directories after commit; Since: 2017.13</doc>
+ line="651">Delete added files/directories after commit; Since: 2017.13</doc>
</member>
<member name="devino_canonical"
value="32"
c:identifier="OSTREE_REPO_COMMIT_MODIFIER_FLAGS_DEVINO_CANONICAL">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="651">If a devino cache hit is found, skip modifier filters (non-directories only); Since: 2017.14</doc>
+ line="652">If a devino cache hit is found, skip modifier filters (non-directories only); Since: 2017.14</doc>
</member>
</bitfield>
<callback name="RepoCommitModifierXattrCallback"
c:type="OstreeRepoCommitModifierXattrCallback">
- <source-position filename="ostree-repo.h" line="679"/>
+ <source-position filename="ostree-repo.h" line="680"/>
<return-value transfer-ownership="full">
<type name="GLib.Variant" c:type="GVariant*"/>
</return-value>
c:type="OstreeRepoCommitState">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="251">Flags representing the state of a commit in the local repository, as returned
+ line="252">Flags representing the state of a commit in the local repository, as returned
by ostree_repo_load_commit().</doc>
- <source-position filename="ostree-repo.h" line="269"/>
+ <source-position filename="ostree-repo.h" line="270"/>
<member name="normal"
value="0"
c:identifier="OSTREE_REPO_COMMIT_STATE_NORMAL">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="253">Commit is complete. This is the default.
+ line="254">Commit is complete. This is the default.
(Since: 2017.14.)</doc>
</member>
<member name="partial"
c:identifier="OSTREE_REPO_COMMIT_STATE_PARTIAL">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="255">One or more objects are missing from the
+ line="256">One or more objects are missing from the
local copy of the commit, but metadata is present. (Since: 2015.7.)</doc>
</member>
<member name="fsck_partial"
c:identifier="OSTREE_REPO_COMMIT_STATE_FSCK_PARTIAL">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="257">One or more objects are missing from the
+ line="258">One or more objects are missing from the
local copy of the commit, due to an fsck --delete. (Since: 2019.4.)</doc>
</member>
</bitfield>
<bitfield name="RepoCommitTraverseFlags"
c:type="OstreeRepoCommitTraverseFlags">
- <source-position filename="ostree-repo.h" line="1121"/>
+ <source-position filename="ostree-repo.h" line="1137"/>
<member name="repo_commit_traverse_flag_none"
value="1"
c:identifier="OSTREE_REPO_COMMIT_TRAVERSE_FLAG_NONE">
</bitfield>
<record name="RepoCommitTraverseIter"
c:type="OstreeRepoCommitTraverseIter">
- <source-position filename="ostree-repo.h" line="1115"/>
+ <source-position filename="ostree-repo.h" line="1131"/>
<field name="initialized" writable="1">
<type name="gboolean" c:type="gboolean"/>
</field>
</field>
<method name="clear"
c:identifier="ostree_repo_commit_traverse_iter_clear">
- <source-position filename="ostree-repo.h" line="1163"/>
+ <source-position filename="ostree-repo.h" line="1179"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
line="235">Return information on the current directory. This function may
only be called if %OSTREE_REPO_COMMIT_ITER_RESULT_DIR was returned
from ostree_repo_commit_traverse_iter_next().</doc>
- <source-position filename="ostree-repo.h" line="1157"/>
+ <source-position filename="ostree-repo.h" line="1173"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
line="214">Return information on the current file. This function may only be
called if %OSTREE_REPO_COMMIT_ITER_RESULT_FILE was returned from
ostree_repo_commit_traverse_iter_next().</doc>
- <source-position filename="ostree-repo.h" line="1152"/>
+ <source-position filename="ostree-repo.h" line="1168"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo-traverse.c"
line="42">Initialize (in place) an iterator over the root of a commit object.</doc>
- <source-position filename="ostree-repo.h" line="1125"/>
+ <source-position filename="ostree-repo.h" line="1141"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<doc xml:space="preserve"
filename="ostree-repo-traverse.c"
line="86">Initialize (in place) an iterator over a directory tree.</doc>
- <source-position filename="ostree-repo.h" line="1133"/>
+ <source-position filename="ostree-repo.h" line="1149"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
If %OSTREE_REPO_COMMIT_ITER_RESULT_ERROR is returned, it is a
program error to call any further API on @iter except for
ostree_repo_commit_traverse_iter_clear().</doc>
- <source-position filename="ostree-repo.h" line="1147"/>
+ <source-position filename="ostree-repo.h" line="1163"/>
<return-value transfer-ownership="none">
<type name="RepoCommitIterResult"
c:type="OstreeRepoCommitIterResult"/>
</method>
<function name="cleanup"
c:identifier="ostree_repo_commit_traverse_iter_cleanup">
- <source-position filename="ostree-repo.h" line="1166"/>
+ <source-position filename="ostree-repo.h" line="1182"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<constructor name="new" c:identifier="ostree_repo_devino_cache_new">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1425">OSTree has support for pairing ostree_repo_checkout_tree_at() using
+ line="1441">OSTree has support for pairing ostree_repo_checkout_tree_at() using
hardlinks in combination with a later
ostree_repo_write_directory_to_mtree() using a (normally modified)
directory. In order for OSTree to optimally detect just the new
files, use this function and fill in the `devino_to_csum_cache`
member of `OstreeRepoCheckoutAtOptions`, then call
ostree_repo_commit_set_devino_cache().</doc>
- <source-position filename="ostree-repo.h" line="975"/>
+ <source-position filename="ostree-repo.h" line="976"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-repo-checkout.c"
- line="1436">Newly allocated cache</doc>
+ line="1452">Newly allocated cache</doc>
<type name="RepoDevInoCache" c:type="OstreeRepoDevInoCache*"/>
</return-value>
</constructor>
<method name="ref" c:identifier="ostree_repo_devino_cache_ref">
- <source-position filename="ostree-repo.h" line="977"/>
+ <source-position filename="ostree-repo.h" line="978"/>
<return-value transfer-ownership="full">
<type name="RepoDevInoCache" c:type="OstreeRepoDevInoCache*"/>
</return-value>
</parameters>
</method>
<method name="unref" c:identifier="ostree_repo_devino_cache_unref">
- <source-position filename="ostree-repo.h" line="979"/>
+ <source-position filename="ostree-repo.h" line="980"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
introspectable="0">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="801">An extensible options structure controlling archive creation. Ensure that
+ line="802">An extensible options structure controlling archive creation. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_export_tree_to_archive().</doc>
- <source-position filename="ostree-repo.h" line="820"/>
+ <source-position filename="ostree-repo.h" line="821"/>
<field name="disable_xattrs" writable="1" bits="1">
<type name="guint" c:type="guint"/>
</field>
introspectable="0">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="772">An extensible options structure controlling archive import. Ensure that
+ line="773">An extensible options structure controlling archive import. Ensure that
you have entirely zeroed the structure, then set just the desired
options. This is used by ostree_repo_import_archive_to_mtree().</doc>
- <source-position filename="ostree-repo.h" line="790"/>
+ <source-position filename="ostree-repo.h" line="791"/>
<field name="ignore_unsupported_content" writable="1" bits="1">
<type name="guint" c:type="guint"/>
</field>
version="2017.11">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="747">Possibly change a pathname while importing an archive. If %NULL is returned,
+ line="748">Possibly change a pathname while importing an archive. If %NULL is returned,
then @src_path will be used unchanged. Otherwise, return a new pathname which
will be freed via `g_free()`.
Note that enabling pathname translation will always override the setting for
`use_ostree_convention`.</doc>
- <source-position filename="ostree-repo.h" line="767"/>
+ <source-position filename="ostree-repo.h" line="768"/>
<return-value transfer-ownership="full">
<type name="utf8" c:type="char*"/>
</return-value>
<parameter name="repo" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="749">Repo</doc>
+ line="750">Repo</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</parameter>
<parameter name="stbuf"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="750">Stat buffer</doc>
+ line="751">Stat buffer</doc>
<type name="gpointer" c:type="const stat*"/>
</parameter>
<parameter name="src_path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="751">Path in the archive</doc>
+ line="752">Path in the archive</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="user_data"
closure="3">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="752">User data</doc>
+ line="753">User data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
<bitfield name="RepoListObjectsFlags" c:type="OstreeRepoListObjectsFlags">
- <source-position filename="ostree-repo.h" line="1018"/>
+ <source-position filename="ostree-repo.h" line="1019"/>
<member name="loose"
value="1"
c:identifier="OSTREE_REPO_LIST_OBJECTS_LOOSE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1008">List only loose (plain file) objects</doc>
+ line="1009">List only loose (plain file) objects</doc>
</member>
<member name="packed"
value="2"
c:identifier="OSTREE_REPO_LIST_OBJECTS_PACKED">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1009">List only packed (compacted into blobs) objects</doc>
+ line="1010">List only packed (compacted into blobs) objects</doc>
</member>
<member name="all" value="4" c:identifier="OSTREE_REPO_LIST_OBJECTS_ALL">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1010">List all objects</doc>
+ line="1011">List all objects</doc>
</member>
<member name="no_parents"
value="8"
c:identifier="OSTREE_REPO_LIST_OBJECTS_NO_PARENTS">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1011">Only list objects in this repo, not parents</doc>
+ line="1012">Only list objects in this repo, not parents</doc>
</member>
</bitfield>
<bitfield name="RepoListRefsExtFlags" c:type="OstreeRepoListRefsExtFlags">
- <source-position filename="ostree-repo.h" line="518"/>
+ <source-position filename="ostree-repo.h" line="519"/>
<member name="none"
value="0"
c:identifier="OSTREE_REPO_LIST_REFS_EXT_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="508">No flags.</doc>
+ line="509">No flags.</doc>
</member>
<member name="aliases"
value="1"
c:identifier="OSTREE_REPO_LIST_REFS_EXT_ALIASES">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="509">Only list aliases. Since: 2017.10</doc>
+ line="510">Only list aliases. Since: 2017.10</doc>
</member>
<member name="exclude_remotes"
value="2"
c:identifier="OSTREE_REPO_LIST_REFS_EXT_EXCLUDE_REMOTES">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="510">Exclude remote refs. Since: 2017.11</doc>
+ line="511">Exclude remote refs. Since: 2017.11</doc>
</member>
<member name="exclude_mirrors"
value="4"
c:identifier="OSTREE_REPO_LIST_REFS_EXT_EXCLUDE_MIRRORS">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="511">Exclude mirrored refs. Since: 2019.2</doc>
+ line="512">Exclude mirrored refs. Since: 2019.2</doc>
</member>
</bitfield>
<enumeration name="RepoMode" c:type="OstreeRepoMode">
</member>
</enumeration>
<bitfield name="RepoPruneFlags" c:type="OstreeRepoPruneFlags">
- <source-position filename="ostree-repo.h" line="1180"/>
+ <source-position filename="ostree-repo.h" line="1196"/>
<member name="none"
value="0"
c:identifier="OSTREE_REPO_PRUNE_FLAGS_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1172">No special options for pruning</doc>
+ line="1188">No special options for pruning</doc>
</member>
<member name="no_prune"
value="1"
c:identifier="OSTREE_REPO_PRUNE_FLAGS_NO_PRUNE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1173">Don't actually delete objects</doc>
+ line="1189">Don't actually delete objects</doc>
</member>
<member name="refs_only"
value="2"
c:identifier="OSTREE_REPO_PRUNE_FLAGS_REFS_ONLY">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1174">Do not traverse individual commit objects, only follow refs</doc>
+ line="1190">Do not traverse individual commit objects, only follow refs</doc>
</member>
</bitfield>
<record name="RepoPruneOptions" c:type="OstreeRepoPruneOptions">
- <source-position filename="ostree-repo.h" line="1208"/>
+ <source-position filename="ostree-repo.h" line="1224"/>
<field name="flags" writable="1">
<type name="RepoPruneFlags" c:type="OstreeRepoPruneFlags"/>
</field>
</field>
</record>
<bitfield name="RepoPullFlags" c:type="OstreeRepoPullFlags">
- <source-position filename="ostree-repo.h" line="1245"/>
+ <source-position filename="ostree-repo.h" line="1261"/>
<member name="none" value="0" c:identifier="OSTREE_REPO_PULL_FLAGS_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1231">No special options for pull</doc>
+ line="1247">No special options for pull</doc>
</member>
<member name="mirror"
value="1"
c:identifier="OSTREE_REPO_PULL_FLAGS_MIRROR">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1232">Write out refs suitable for mirrors and fetch all refs if none requested</doc>
+ line="1248">Write out refs suitable for mirrors and fetch all refs if none requested</doc>
</member>
<member name="commit_only"
value="2"
c:identifier="OSTREE_REPO_PULL_FLAGS_COMMIT_ONLY">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1233">Fetch only the commit metadata</doc>
+ line="1249">Fetch only the commit metadata</doc>
</member>
<member name="untrusted"
value="4"
c:identifier="OSTREE_REPO_PULL_FLAGS_UNTRUSTED">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1234">Do verify checksums of local (filesystem-accessible) repositories (defaults on for HTTP)</doc>
+ line="1250">Do verify checksums of local (filesystem-accessible) repositories (defaults on for HTTP)</doc>
</member>
<member name="bareuseronly_files"
value="8"
c:identifier="OSTREE_REPO_PULL_FLAGS_BAREUSERONLY_FILES">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1235">Since 2017.7. Reject writes of content objects with modes outside of 0775.</doc>
+ line="1251">Since 2017.7. Reject writes of content objects with modes outside of 0775.</doc>
</member>
<member name="trusted_http"
value="16"
c:identifier="OSTREE_REPO_PULL_FLAGS_TRUSTED_HTTP">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1236">Don't verify checksums of objects HTTP repositories (Since: 2017.12)</doc>
+ line="1252">Don't verify checksums of objects HTTP repositories (Since: 2017.12)</doc>
</member>
</bitfield>
<enumeration name="RepoRemoteChange" c:type="OstreeRepoRemoteChange">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="165">The remote change operation.</doc>
- <source-position filename="ostree-repo.h" line="180"/>
+ line="166">The remote change operation.</doc>
+ <source-position filename="ostree-repo.h" line="181"/>
<member name="add"
value="0"
c:identifier="OSTREE_REPO_REMOTE_CHANGE_ADD">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="168">Add a remote</doc>
+ line="169">Add a remote</doc>
</member>
<member name="add_if_not_exists"
value="1"
c:identifier="OSTREE_REPO_REMOTE_CHANGE_ADD_IF_NOT_EXISTS">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="169">Like above, but do nothing if the remote exists</doc>
+ line="170">Like above, but do nothing if the remote exists</doc>
</member>
<member name="delete"
value="2"
c:identifier="OSTREE_REPO_REMOTE_CHANGE_DELETE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="170">Delete a remote</doc>
+ line="171">Delete a remote</doc>
</member>
<member name="delete_if_exists"
value="3"
c:identifier="OSTREE_REPO_REMOTE_CHANGE_DELETE_IF_EXISTS">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="171">Delete a remote, do nothing if the remote does not exist</doc>
+ line="172">Delete a remote, do nothing if the remote does not exist</doc>
</member>
<member name="replace"
value="4"
c:identifier="OSTREE_REPO_REMOTE_CHANGE_REPLACE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="172">Add or replace a remote (Since: 2019.2)</doc>
+ line="173">Add or replace a remote (Since: 2019.2)</doc>
</member>
</enumeration>
<bitfield name="RepoResolveRevExtFlags"
c:type="OstreeRepoResolveRevExtFlags">
- <source-position filename="ostree-repo.h" line="480"/>
+ <source-position filename="ostree-repo.h" line="481"/>
<member name="none"
value="0"
c:identifier="OSTREE_REPO_RESOLVE_REV_EXT_NONE">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="474">No flags.</doc>
+ line="475">No flags.</doc>
</member>
<member name="local_only"
value="1"
c:identifier="OSTREE_REPO_RESOLVE_REV_EXT_LOCAL_ONLY">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="475">Exclude remote and mirrored refs. Since: 2019.2</doc>
+ line="476">Exclude remote and mirrored refs. Since: 2019.2</doc>
</member>
</bitfield>
<record name="RepoTransactionStats"
c:symbol-prefix="repo_transaction_stats">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="271">A list of statistics for each transaction that may be
+ line="272">A list of statistics for each transaction that may be
interesting for reporting purposes.</doc>
- <source-position filename="ostree-repo.h" line="305"/>
+ <source-position filename="ostree-repo.h" line="306"/>
<field name="metadata_objects_total" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="273">The total number of metadata objects
+ line="274">The total number of metadata objects
in the repository after this transaction has completed.</doc>
<type name="guint" c:type="guint"/>
</field>
<field name="metadata_objects_written" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="275">The number of metadata objects that
+ line="276">The number of metadata objects that
were written to the repository in this transaction.</doc>
<type name="guint" c:type="guint"/>
</field>
<field name="content_objects_total" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="277">The total number of content objects
+ line="278">The total number of content objects
in the repository after this transaction has completed.</doc>
<type name="guint" c:type="guint"/>
</field>
<field name="content_objects_written" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="279">The number of content objects that
+ line="280">The number of content objects that
were written to the repository in this transaction.</doc>
<type name="guint" c:type="guint"/>
</field>
<field name="content_bytes_written" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="281">The amount of data added to the repository,
+ line="282">The amount of data added to the repository,
in bytes, counting only content objects.</doc>
<type name="guint64" c:type="guint64"/>
</field>
<field name="padding1" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="283">reserved</doc>
+ line="284">reserved</doc>
<type name="guint" c:type="guint"/>
</field>
<field name="padding2" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="284">reserved</doc>
+ line="285">reserved</doc>
<type name="guint64" c:type="guint64"/>
</field>
<field name="padding3" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="285">reserved</doc>
+ line="286">reserved</doc>
<type name="guint64" c:type="guint64"/>
</field>
<field name="padding4" writable="1">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="286">reserved</doc>
+ line="287">reserved</doc>
<type name="guint64" c:type="guint64"/>
</field>
</record>
c:type="OstreeStaticDeltaGenerateOpt">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1048">Parameters controlling optimization of static deltas.</doc>
- <source-position filename="ostree-repo.h" line="1058"/>
+ line="1049">Parameters controlling optimization of static deltas.</doc>
+ <source-position filename="ostree-repo.h" line="1059"/>
<member name="lowlatency"
value="0"
c:identifier="OSTREE_STATIC_DELTA_GENERATE_OPT_LOWLATENCY">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1050">Optimize for speed of delta creation over space</doc>
+ line="1051">Optimize for speed of delta creation over space</doc>
</member>
<member name="major"
value="1"
c:identifier="OSTREE_STATIC_DELTA_GENERATE_OPT_MAJOR">
<doc xml:space="preserve"
filename="ostree-repo.h"
- line="1051">Optimize for delta size (may be very slow)</doc>
+ line="1052">Optimize for delta size (may be very slow)</doc>
</member>
</enumeration>
<class name="Sysroot"
<constructor name="new" c:identifier="ostree_sysroot_new">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="201">Create a new #OstreeSysroot object for the sysroot at @path. If @path is %NULL,
+ line="202">Create a new #OstreeSysroot object for the sysroot at @path. If @path is %NULL,
the current visible root file system is used, equivalent to
ostree_sysroot_new_default().</doc>
<source-position filename="ostree-sysroot.h" line="39"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="210">An accessor object for an system root located at @path</doc>
+ line="211">An accessor object for an system root located at @path</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</return-value>
<parameters>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="203">Path to a system root directory, or %NULL to use the
+ line="204">Path to a system root directory, or %NULL to use the
current visible root file system</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="221">An accessor for the current visible root / filesystem</doc>
+ line="222">An accessor for the current visible root / filesystem</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</return-value>
</constructor>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1248">Path to deployment origin file</doc>
+ line="1271">Path to deployment origin file</doc>
<type name="Gio.File" c:type="GFile*"/>
</return-value>
<parameters>
<parameter name="deployment_path" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1246">A deployment path</doc>
+ line="1269">A deployment path</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
</parameters>
<method name="cleanup" c:identifier="ostree_sysroot_cleanup" throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="500">Delete any state that resulted from a partially completed
+ line="543">Delete any state that resulted from a partially completed
transaction, such as incomplete deployments.</doc>
<source-position filename="ostree-sysroot.h" line="127"/>
<return-value transfer-ownership="none">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="502">Sysroot</doc>
+ line="545">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="503">Cancellable</doc>
+ line="546">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="424">Prune the system repository. This is a thin wrapper
+ line="467">Prune the system repository. This is a thin wrapper
around ostree_repo_prune_from_reachable(); the primary
addition is that this function automatically gathers
all deployed commits into the reachable set.
<instance-parameter name="sysroot" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="426">Sysroot</doc>
+ line="469">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="427">Flags controlling pruning</doc>
+ line="470">Flags controlling pruning</doc>
<type name="RepoPruneOptions" c:type="OstreeRepoPruneOptions*"/>
</parameter>
<parameter name="out_objects_total"
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="428">Number of objects found</doc>
+ line="471">Number of objects found</doc>
<type name="gint" c:type="gint*"/>
</parameter>
<parameter name="out_objects_pruned"
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="429">Number of objects deleted</doc>
+ line="472">Number of objects deleted</doc>
<type name="gint" c:type="gint*"/>
</parameter>
<parameter name="out_pruned_object_size_total"
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="430">Storage size in bytes of objects deleted</doc>
+ line="473">Storage size in bytes of objects deleted</doc>
<type name="guint64" c:type="guint64*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="431">Cancellable</doc>
+ line="474">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</method>
<method name="deploy_tree"
c:identifier="ostree_sysroot_deploy_tree"
+ version="2018.5"
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2850">Check out deployment tree with revision @revision, performing a 3
-way merge with @provided_merge_deployment for configuration.
-
-When booted into the sysroot, you should use the
-ostree_sysroot_stage_tree() API instead.</doc>
- <source-position filename="ostree-sysroot.h" line="190"/>
+ line="2954">Older version of ostree_sysroot_stage_tree_with_options().</doc>
+ <source-position filename="ostree-sysroot.h" line="205"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2852">Sysroot</doc>
+ line="2956">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="osname"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2853">osname to use for merge deployment</doc>
+ line="2957">osname to use for merge deployment</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="revision" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2854">Checksum to add</doc>
+ line="2958">Checksum to add</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="origin"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2855">Origin to use for upgrades</doc>
+ line="2959">Origin to use for upgrades</doc>
<type name="GLib.KeyFile" c:type="GKeyFile*"/>
</parameter>
<parameter name="provided_merge_deployment"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2856">Use this deployment for merge path</doc>
+ line="2960">Use this deployment for merge path</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="override_kernel_argv"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2857">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment</doc>
+ line="2961">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment</doc>
<array c:type="char**">
<type name="utf8"/>
</array>
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2858">The new deployment path</doc>
+ line="2962">The new deployment path</doc>
+ <type name="Deployment" c:type="OstreeDeployment**"/>
+ </parameter>
+ <parameter name="cancellable"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2963">Cancellable</doc>
+ <type name="Gio.Cancellable" c:type="GCancellable*"/>
+ </parameter>
+ </parameters>
+ </method>
+ <method name="deploy_tree_with_options"
+ c:identifier="ostree_sysroot_deploy_tree_with_options"
+ version="2020.7"
+ throws="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2907">Check out deployment tree with revision @revision, performing a 3
+way merge with @provided_merge_deployment for configuration.
+
+When booted into the sysroot, you should use the
+ostree_sysroot_stage_tree() API instead.</doc>
+ <source-position filename="ostree-sysroot.h" line="216"/>
+ <return-value transfer-ownership="none">
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2909">Sysroot</doc>
+ <type name="Sysroot" c:type="OstreeSysroot*"/>
+ </instance-parameter>
+ <parameter name="osname"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2910">osname to use for merge deployment</doc>
+ <type name="utf8" c:type="const char*"/>
+ </parameter>
+ <parameter name="revision" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2911">Checksum to add</doc>
+ <type name="utf8" c:type="const char*"/>
+ </parameter>
+ <parameter name="origin"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2912">Origin to use for upgrades</doc>
+ <type name="GLib.KeyFile" c:type="GKeyFile*"/>
+ </parameter>
+ <parameter name="provided_merge_deployment"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2913">Use this deployment for merge path</doc>
+ <type name="Deployment" c:type="OstreeDeployment*"/>
+ </parameter>
+ <parameter name="opts"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2914">Options</doc>
+ <type name="SysrootDeployTreeOpts"
+ c:type="OstreeSysrootDeployTreeOpts*"/>
+ </parameter>
+ <parameter name="out_new_deployment"
+ direction="out"
+ caller-allocates="0"
+ transfer-ownership="full">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="2915">The new deployment path</doc>
<type name="Deployment" c:type="OstreeDeployment**"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2859">Cancellable</doc>
+ line="2916">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3191">Entirely replace the kernel arguments of @deployment with the
+ line="3377">Entirely replace the kernel arguments of @deployment with the
values in @new_kargs.</doc>
<source-position filename="ostree-sysroot.h" line="163"/>
<return-value transfer-ownership="none">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3193">Sysroot</doc>
+ line="3379">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3194">A deployment</doc>
+ line="3380">A deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="new_kargs" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3195">Replace deployment's kernel arguments</doc>
+ line="3381">Replace deployment's kernel arguments</doc>
<array c:type="char**">
<type name="utf8"/>
</array>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3196">Cancellable</doc>
+ line="3382">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3240">By default, deployment directories are not mutable. This function
+ line="3426">By default, deployment directories are not mutable. This function
will allow making them temporarily mutable, for example to allow
layering additional non-OSTree content.</doc>
- <source-position filename="ostree-sysroot.h" line="212"/>
+ <source-position filename="ostree-sysroot.h" line="250"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3242">Sysroot</doc>
+ line="3428">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3243">A deployment</doc>
+ line="3429">A deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="is_mutable" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3244">Whether or not deployment's files can be changed</doc>
+ line="3430">Whether or not deployment's files can be changed</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="3245">Cancellable</doc>
+ line="3431">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="2077">By default, deployments may be subject to garbage collection. Typical uses of
+ line="2100">By default, deployments may be subject to garbage collection. Typical uses of
libostree only retain at most 2 deployments. If @is_pinned is `TRUE`, a
metadata bit will be set causing libostree to avoid automatic GC of the
deployment. However, this is really an "advisory" note; it's still possible
This function does nothing and returns successfully if the deployment
is already in the desired pinning state. It is an error to try to pin
the staged deployment (as it's not in the bootloader entries).</doc>
- <source-position filename="ostree-sysroot.h" line="219"/>
+ <source-position filename="ostree-sysroot.h" line="257"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="2079">Sysroot</doc>
+ line="2102">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="2080">A deployment</doc>
+ line="2103">A deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="is_pinned" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="2081">Whether or not deployment will be automatically GC'd</doc>
+ line="2104">Whether or not deployment will be automatically GC'd</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1871">Configure the target deployment @deployment such that it
+ line="1894">Configure the target deployment @deployment such that it
is writable. There are multiple modes, essentially differing
in whether or not any changes persist across reboot.
The `OSTREE_DEPLOYMENT_UNLOCKED_HOTFIX` state is persistent
across reboots.</doc>
- <source-position filename="ostree-sysroot.h" line="225"/>
+ <source-position filename="ostree-sysroot.h" line="263"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1873">Sysroot</doc>
+ line="1896">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1874">Deployment</doc>
+ line="1897">Deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="unlocked_state" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1875">Transition to this unlocked state</doc>
+ line="1898">Transition to this unlocked state</doc>
<type name="DeploymentUnlockedState"
c:type="OstreeDeploymentUnlockedState"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1876">Cancellable</doc>
+ line="1899">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="383">Ensure that @self is set up as a valid rootfs, by creating
+ line="384">Ensure that @self is set up as a valid rootfs, by creating
/ostree/repo, among other things.</doc>
<source-position filename="ostree-sysroot.h" line="75"/>
<return-value transfer-ownership="none">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="385">Sysroot</doc>
+ line="386">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="386">Cancellable</doc>
+ line="387">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1165">The currently booted deployment, or %NULL if none</doc>
+ line="1188">The currently booted deployment, or %NULL if none</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1163">Sysroot</doc>
+ line="1186">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1234">Path to deployment root directory</doc>
+ line="1257">Path to deployment root directory</doc>
<type name="Gio.File" c:type="GFile*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1231">Sysroot</doc>
+ line="1254">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1232">A deployment</doc>
+ line="1255">A deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
</parameters>
c:identifier="ostree_sysroot_get_deployment_dirpath">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1208">Note this function only returns a *relative* path - if you want
+ line="1231">Note this function only returns a *relative* path - if you want
to access, it, you must either use fd-relative api such as openat(),
or concatenate it with the full ostree_sysroot_get_path().</doc>
<source-position filename="ostree-sysroot.h" line="95"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1217">Path to deployment root directory, relative to sysroot</doc>
+ line="1240">Path to deployment root directory, relative to sysroot</doc>
<type name="utf8" c:type="char*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1210">Repo</doc>
+ line="1233">Repo</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1211">A deployment</doc>
+ line="1234">A deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
</parameters>
<return-value transfer-ownership="container">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1195">Ordered list of deployments</doc>
+ line="1218">Ordered list of deployments</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="Deployment"/>
</array>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1193">Sysroot</doc>
+ line="1216">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
<method name="get_fd" c:identifier="ostree_sysroot_get_fd">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="320">Access a file descriptor that refers to the root directory of this sysroot.
+ line="321">Access a file descriptor that refers to the root directory of this sysroot.
ostree_sysroot_initialize() (or ostree_sysroot_load()) must have been invoked
prior to calling this function.</doc>
<source-position filename="ostree-sysroot.h" line="54"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="328">A file descriptor valid for the lifetime of @self</doc>
+ line="329">A file descriptor valid for the lifetime of @self</doc>
<type name="gint" c:type="int"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="322">Sysroot</doc>
+ line="323">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
c:identifier="ostree_sysroot_get_merge_deployment">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1426">Find the deployment to use as a configuration merge source; this is
+ line="1449">Find the deployment to use as a configuration merge source; this is
the first one in the current deployment list which matches osname.</doc>
- <source-position filename="ostree-sysroot.h" line="238"/>
+ <source-position filename="ostree-sysroot.h" line="276"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1434">Configuration merge deployment</doc>
+ line="1457">Configuration merge deployment</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1428">Sysroot</doc>
+ line="1451">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="osname"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1429">Operating system group</doc>
+ line="1452">Operating system group</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="260">Path to rootfs</doc>
+ line="261">Path to rootfs</doc>
<type name="Gio.File" c:type="GFile*"/>
</return-value>
<parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1259">Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open
+ line="1282">Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open
(see ostree_repo_open()).</doc>
<source-position filename="ostree-sysroot.h" line="157"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1269">%TRUE on success, %FALSE otherwise</doc>
+ line="1292">%TRUE on success, %FALSE otherwise</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1261">Sysroot</doc>
+ line="1284">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="out_repo"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1262">Repository in sysroot @self</doc>
+ line="1285">Repository in sysroot @self</doc>
<type name="Repo" c:type="OstreeRepo**"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1263">Cancellable</doc>
+ line="1286">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1179">The currently staged deployment, or %NULL if none</doc>
+ line="1202">The currently staged deployment, or %NULL if none</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1177">Sysroot</doc>
+ line="1200">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1622">Initialize the directory structure for an "osname", which is a
+ line="1645">Initialize the directory structure for an "osname", which is a
group of operating system deployments, with a shared `/var`. One
is required for generating a deployment.</doc>
<source-position filename="ostree-sysroot.h" line="121"/>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1624">Sysroot</doc>
+ line="1647">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="osname" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1625">Name group of operating system checkouts</doc>
+ line="1648">Name group of operating system checkouts</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1626">Cancellable</doc>
+ line="1649">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="887">Subset of ostree_sysroot_load(); performs basic initialization. Notably, one
+ line="906">Subset of ostree_sysroot_load(); performs basic initialization. Notably, one
can invoke `ostree_sysroot_get_fd()` after calling this function.
It is not necessary to call this function if ostree_sysroot_load() is
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="889">sysroot</doc>
+ line="908">sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
version="2020.1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="337">Can only be invoked after `ostree_sysroot_initialize()`.</doc>
+ line="338">Can only be invoked after `ostree_sysroot_initialize()`.</doc>
<source-position filename="ostree-sysroot.h" line="51"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="343">%TRUE iff the sysroot points to a booted deployment</doc>
+ line="344">%TRUE iff the sysroot points to a booted deployment</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="339">Sysroot</doc>
+ line="340">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
<method name="load" c:identifier="ostree_sysroot_load" throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="843">Load deployment list, bootversion, and subbootversion from the
+ line="862">Load deployment list, bootversion, and subbootversion from the
rootfs @self.</doc>
<source-position filename="ostree-sysroot.h" line="61"/>
<return-value transfer-ownership="none">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="845">Sysroot</doc>
+ line="864">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="846">Cancellable</doc>
+ line="865">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1095">#OstreeSysroot</doc>
+ line="1118">#OstreeSysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="out_changed"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1097">Cancellable</doc>
+ line="1120">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
<method name="lock" c:identifier="ostree_sysroot_lock" throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1476">Acquire an exclusive multi-process write lock for @self. This call
+ line="1499">Acquire an exclusive multi-process write lock for @self. This call
blocks until the lock has been acquired. The lock is not
reentrant.
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1478">Self</doc>
+ line="1501">Self</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
<method name="lock_async" c:identifier="ostree_sysroot_lock_async">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1586">An asynchronous version of ostree_sysroot_lock().</doc>
+ line="1609">An asynchronous version of ostree_sysroot_lock().</doc>
<source-position filename="ostree-sysroot.h" line="109"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1588">Self</doc>
+ line="1611">Self</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1589">Cancellable</doc>
+ line="1612">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
<parameter name="callback"
closure="2">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1590">Callback</doc>
+ line="1613">Callback</doc>
<type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
</parameter>
<parameter name="user_data"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1591">User data</doc>
+ line="1614">User data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1605">Call when ostree_sysroot_lock_async() is ready.</doc>
+ line="1628">Call when ostree_sysroot_lock_async() is ready.</doc>
<source-position filename="ostree-sysroot.h" line="114"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1607">Self</doc>
+ line="1630">Self</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="result" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1608">Result</doc>
+ line="1631">Result</doc>
<type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
</parameter>
</parameters>
</method>
<method name="origin_new_from_refspec"
c:identifier="ostree_sysroot_origin_new_from_refspec">
- <source-position filename="ostree-sysroot.h" line="243"/>
+ <source-position filename="ostree-sysroot.h" line="281"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1465">A new config file which sets @refspec as an origin</doc>
+ line="1488">A new config file which sets @refspec as an origin</doc>
<type name="GLib.KeyFile" c:type="GKeyFile*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1462">Sysroot</doc>
+ line="1485">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="refspec" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1463">A refspec</doc>
+ line="1486">A refspec</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="517">Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments
+ line="560">Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments
and old boot versions, but does NOT prune the repository.</doc>
<source-position filename="ostree-sysroot.h" line="132"/>
<return-value transfer-ownership="none">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="519">Sysroot</doc>
+ line="562">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-cleanup.c"
- line="520">Cancellable</doc>
+ line="563">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
version="2017.7">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1369">Find the pending and rollback deployments for @osname. Pass %NULL for @osname
+ line="1392">Find the pending and rollback deployments for @osname. Pass %NULL for @osname
to use the booted deployment's osname. By default, pending deployment is the
first deployment in the order that matches @osname, and @rollback will be the
next one after the booted deployment, or the deployment after the pending if
we're not looking at the booted deployment.</doc>
- <source-position filename="ostree-sysroot.h" line="232"/>
+ <source-position filename="ostree-sysroot.h" line="270"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1371">Sysroot</doc>
+ line="1394">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="osname"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1372">"stateroot" name</doc>
+ line="1395">"stateroot" name</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="out_pending"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1373">The pending deployment</doc>
+ line="1396">The pending deployment</doc>
<type name="Deployment" c:type="OstreeDeployment**"/>
</parameter>
<parameter name="out_rollback"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1374">The rollback deployment</doc>
+ line="1397">The rollback deployment</doc>
<type name="Deployment" c:type="OstreeDeployment**"/>
</parameter>
</parameters>
<method name="repo" c:identifier="ostree_sysroot_repo" version="2017.7">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1284">This function is a variant of ostree_sysroot_get_repo() that cannot fail, and
+ line="1307">This function is a variant of ostree_sysroot_get_repo() that cannot fail, and
returns a cached repository. Can only be called after ostree_sysroot_initialize()
or ostree_sysroot_load() has been invoked successfully.</doc>
<source-position filename="ostree-sysroot.h" line="154"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1292">The OSTree repository in sysroot @self.</doc>
+ line="1315">The OSTree repository in sysroot @self.</doc>
<type name="Repo" c:type="OstreeRepo*"/>
</return-value>
<parameters>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1286">Sysroot</doc>
+ line="1309">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
version="2020.1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="229">If this function is invoked, then libostree will assume that
+ line="230">If this function is invoked, then libostree will assume that
a private Linux mount namespace has been created by the process.
The primary use case for this is to have e.g. /sysroot mounted
read-only by default.
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1686">Prepend @new_deployment to the list of deployments, commit, and
+ line="1709">Prepend @new_deployment to the list of deployments, commit, and
cleanup. By default, all other deployments for the given @osname
except the merge deployment and the booted deployment will be
garbage collected.
specified, then no cleanup will be performed after adding the
deployment. Make sure to call ostree_sysroot_cleanup() sometime
later, instead.</doc>
- <source-position filename="ostree-sysroot.h" line="256"/>
+ <source-position filename="ostree-sysroot.h" line="294"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="sysroot" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1688">Sysroot</doc>
+ line="1711">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="osname"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1689">OS name</doc>
+ line="1712">OS name</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="new_deployment" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1690">Prepend this deployment to the list</doc>
+ line="1713">Prepend this deployment to the list</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="merge_deployment"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1691">Use this deployment for configuration merge</doc>
+ line="1714">Use this deployment for configuration merge</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1692">Flags controlling behavior</doc>
+ line="1715">Flags controlling behavior</doc>
<type name="SysrootSimpleWriteDeploymentFlags"
c:type="OstreeSysrootSimpleWriteDeploymentFlags"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1693">Cancellable</doc>
+ line="1716">Cancellable</doc>
+ <type name="Gio.Cancellable" c:type="GCancellable*"/>
+ </parameter>
+ </parameters>
+ </method>
+ <method name="stage_overlay_initrd"
+ c:identifier="ostree_sysroot_stage_overlay_initrd"
+ version="2020.7"
+ throws="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3046">Stage an overlay initrd to be used in an upcoming deployment. Returns a checksum which
+can be passed to ostree_sysroot_deploy_tree_with_options() or
+ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option.</doc>
+ <source-position filename="ostree-sysroot.h" line="190"/>
+ <return-value transfer-ownership="none">
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3048">Sysroot</doc>
+ <type name="Sysroot" c:type="OstreeSysroot*"/>
+ </instance-parameter>
+ <parameter name="fd" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3049">File descriptor to overlay initrd</doc>
+ <type name="gint" c:type="int"/>
+ </parameter>
+ <parameter name="out_checksum"
+ direction="out"
+ caller-allocates="0"
+ transfer-ownership="full">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3050">Overlay initrd checksum</doc>
+ <type name="utf8" c:type="char**"/>
+ </parameter>
+ <parameter name="cancellable"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3051">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2954">Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS
-shutdown time.</doc>
- <source-position filename="ostree-sysroot.h" line="201"/>
+ line="3103">Older version of ostree_sysroot_stage_tree_with_options().</doc>
+ <source-position filename="ostree-sysroot.h" line="227"/>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2956">Sysroot</doc>
+ line="3105">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="osname"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2957">osname to use for merge deployment</doc>
+ line="3106">osname to use for merge deployment</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="revision" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2958">Checksum to add</doc>
+ line="3107">Checksum to add</doc>
<type name="utf8" c:type="const char*"/>
</parameter>
<parameter name="origin"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2959">Origin to use for upgrades</doc>
+ line="3108">Origin to use for upgrades</doc>
<type name="GLib.KeyFile" c:type="GKeyFile*"/>
</parameter>
<parameter name="merge_deployment"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2960">Use this deployment for merge path</doc>
+ line="3109">Use this deployment for merge path</doc>
<type name="Deployment" c:type="OstreeDeployment*"/>
</parameter>
<parameter name="override_kernel_argv"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2961">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment</doc>
+ line="3110">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment</doc>
<array c:type="char**">
<type name="utf8"/>
</array>
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2962">The new deployment path</doc>
+ line="3111">The new deployment path</doc>
<type name="Deployment" c:type="OstreeDeployment**"/>
</parameter>
<parameter name="cancellable"
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2963">Cancellable</doc>
+ line="3112">Cancellable</doc>
+ <type name="Gio.Cancellable" c:type="GCancellable*"/>
+ </parameter>
+ </parameters>
+ </method>
+ <method name="stage_tree_with_options"
+ c:identifier="ostree_sysroot_stage_tree_with_options"
+ version="2020.7"
+ throws="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3137">Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS
+shutdown time.</doc>
+ <source-position filename="ostree-sysroot.h" line="238"/>
+ <return-value transfer-ownership="none">
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="self" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3139">Sysroot</doc>
+ <type name="Sysroot" c:type="OstreeSysroot*"/>
+ </instance-parameter>
+ <parameter name="osname"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3140">osname to use for merge deployment</doc>
+ <type name="utf8" c:type="const char*"/>
+ </parameter>
+ <parameter name="revision" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3141">Checksum to add</doc>
+ <type name="utf8" c:type="const char*"/>
+ </parameter>
+ <parameter name="origin"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3142">Origin to use for upgrades</doc>
+ <type name="GLib.KeyFile" c:type="GKeyFile*"/>
+ </parameter>
+ <parameter name="merge_deployment"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3143">Use this deployment for merge path</doc>
+ <type name="Deployment" c:type="OstreeDeployment*"/>
+ </parameter>
+ <parameter name="opts" transfer-ownership="none">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3144">Options</doc>
+ <type name="SysrootDeployTreeOpts"
+ c:type="OstreeSysrootDeployTreeOpts*"/>
+ </parameter>
+ <parameter name="out_new_deployment"
+ direction="out"
+ caller-allocates="0"
+ transfer-ownership="full">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3145">The new deployment path</doc>
+ <type name="Deployment" c:type="OstreeDeployment**"/>
+ </parameter>
+ <parameter name="cancellable"
+ transfer-ownership="none"
+ nullable="1"
+ allow-none="1">
+ <doc xml:space="preserve"
+ filename="ostree-sysroot-deploy.c"
+ line="3146">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1502">Try to acquire an exclusive multi-process write lock for @self. If
+ line="1525">Try to acquire an exclusive multi-process write lock for @self. If
another process holds the lock, this function will return
immediately, setting @out_acquired to %FALSE, and returning %TRUE
(and no error).
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1504">Self</doc>
+ line="1527">Self</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="out_acquired"
transfer-ownership="full">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1505">Whether or not the lock has been acquired</doc>
+ line="1528">Whether or not the lock has been acquired</doc>
<type name="gboolean" c:type="gboolean*"/>
</parameter>
</parameters>
<method name="unload" c:identifier="ostree_sysroot_unload">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="366">Release any resources such as file descriptors referring to the
+ line="367">Release any resources such as file descriptors referring to the
root directory of this sysroot. Normally, those resources are
cleared by finalization, but in garbage collected languages that
may not be predictable.
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="368">Sysroot</doc>
+ line="369">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
<method name="unlock" c:identifier="ostree_sysroot_unlock">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1550">Clear the lock previously acquired with ostree_sysroot_lock(). It
+ line="1573">Clear the lock previously acquired with ostree_sysroot_lock(). It
is safe to call this function if the lock has not been previously
acquired.</doc>
<source-position filename="ostree-sysroot.h" line="118"/>
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot.c"
- line="1552">Self</doc>
+ line="1575">Self</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2226">Older version of ostree_sysroot_write_deployments_with_options(). This
+ line="2282">Older version of ostree_sysroot_write_deployments_with_options(). This
version will perform post-deployment cleanup by default.</doc>
<source-position filename="ostree-sysroot.h" line="170"/>
<return-value transfer-ownership="none">
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2228">Sysroot</doc>
+ line="2284">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="new_deployments" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2229">List of new deployments</doc>
+ line="2285">List of new deployments</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="Deployment"/>
</array>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2230">Cancellable</doc>
+ line="2286">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
throws="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2352">Assuming @new_deployments have already been deployed in place on disk via
+ line="2408">Assuming @new_deployments have already been deployed in place on disk via
ostree_sysroot_deploy_tree(), atomically update bootloader configuration. By
default, no post-transaction cleanup will be performed. You should invoke
ostree_sysroot_cleanup() at some point after the transaction, or specify
<instance-parameter name="self" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2354">Sysroot</doc>
+ line="2410">Sysroot</doc>
<type name="Sysroot" c:type="OstreeSysroot*"/>
</instance-parameter>
<parameter name="new_deployments" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2355">List of new deployments</doc>
+ line="2411">List of new deployments</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="Deployment"/>
</array>
<parameter name="opts" transfer-ownership="none">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2356">Options</doc>
+ line="2412">Options</doc>
<type name="SysrootWriteDeploymentsOpts"
c:type="OstreeSysrootWriteDeploymentsOpts*"/>
</parameter>
allow-none="1">
<doc xml:space="preserve"
filename="ostree-sysroot-deploy.c"
- line="2357">Cancellable</doc>
+ line="2413">Cancellable</doc>
<type name="Gio.Cancellable" c:type="GCancellable*"/>
</parameter>
</parameters>
</parameters>
</glib:signal>
</class>
+ <record name="SysrootDeployTreeOpts" c:type="OstreeSysrootDeployTreeOpts">
+ <source-position filename="ostree-sysroot.h" line="202"/>
+ <field name="unused_bools" writable="1">
+ <array zero-terminated="0" fixed-size="8">
+ <type name="gboolean" c:type="gboolean"/>
+ </array>
+ </field>
+ <field name="unused_ints" writable="1">
+ <array zero-terminated="0" fixed-size="8">
+ <type name="gint" c:type="int"/>
+ </array>
+ </field>
+ <field name="override_kernel_argv" writable="1">
+ <type name="utf8" c:type="char**"/>
+ </field>
+ <field name="overlay_initrds" writable="1">
+ <type name="utf8" c:type="char**"/>
+ </field>
+ <field name="unused_ptrs" writable="1">
+ <array zero-terminated="0" fixed-size="6">
+ <type name="gpointer" c:type="gpointer"/>
+ </array>
+ </field>
+ </record>
<bitfield name="SysrootSimpleWriteDeploymentFlags"
c:type="OstreeSysrootSimpleWriteDeploymentFlags">
- <source-position filename="ostree-sysroot.h" line="253"/>
+ <source-position filename="ostree-sysroot.h" line="291"/>
<member name="none"
value="0"
c:identifier="OSTREE_SYSROOT_SIMPLE_WRITE_DEPLOYMENT_FLAGS_NONE">
<source-position filename="ostree-tls-cert-interaction.h" line="35"/>
</record>
<constant name="VERSION"
- value="2020.600000"
+ value="2020.700000"
c:type="OSTREE_VERSION"
version="2017.4">
<doc xml:space="preserve"
<type name="gdouble" c:type="gdouble"/>
</constant>
<constant name="VERSION_S"
- value="2020.6"
+ value="2020.7"
c:type="OSTREE_VERSION_S"
version="2017.4">
<doc xml:space="preserve"
<function name="repo_commit_traverse_iter_cleanup"
c:identifier="ostree_repo_commit_traverse_iter_cleanup"
moved-to="RepoCommitTraverseIter.cleanup">
- <source-position filename="ostree-repo.h" line="1166"/>
+ <source-position filename="ostree-repo.h" line="1182"/>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>